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1 What is a computer? 


A computer is a general purpose electronic machine that can be 
instructed to do a great variety of things - play games, perform complex 
calculations, store and retrieve information, display graphs and so on. 

You can ask a computer to do things directly- by typing commands on its 
keyboard - but for complex tasks, a whole series of instructions is usually 
written and stored in the computer’s memory. The computer can be 
instructed to call up these instructions one by one and carry them out, 
very fast. (Your Electron can carry out, or ‘execute’, over 250,000 
separate instructions every second.) 

A series of instructions like this is called a program. Programs can be 
recorded onto cassette by using a suitable cassette recorder in much the 
same way as you might record a piece of music. The main difference is 
that the recording is made from a computer, and is played back into the 
computer again. You can buy pre-recorded programs which have been 
written by other people, and to start you off, several programs are 
provided on the Introductory Cassette which comes with your Electron. 

The first part of this book describes how to set up your computer, and 
load and run the programs on the Introductory Cassette. For information 
on other programs available for the Electron (the general name for 
programs is ‘software’), write to: 

Acornsoft Limited 
4 a Market Hill 
Cambridge CB2 3NJ 

The remainder of this book (chapter 4 onwards), and the book Start 
Programming with the Electron, will tell you how to write your own 
programs on your Electron computer. You do not need to know this in 
order to use your computer, as there are many commercially available 
programs - but we hope that you will be interested and will want to find 
out more about your Electron. 




2 Getting started 


Welcome to the Acorn Electron Microcomputer! 

Chapters 2 and 3 explain how to connect your Electron to the mains and 
to a television or monitor. Please read them carefully before continuing. 


Checklist of items 

Apart from this User Guide, you should have the following items in the 
box you’ve just opened: 

- An Electron Microcomputer 

- A mains adapter 

- Guarantee registration card 

- An aerial lead about two metres long for connecting the computer to 
your television set 

- The Introductory Cassette 

- A book called Start Programming with the Electron 

If any of these items are missing, please contact your supplier. 

Additional items 

You will also need the following: 

- A television set, or a good quality monochrome or colour monitor 

- A mono (or stereo) cassette recorder, preferably with these facilities: 

An external motor control facility 

Record/playback socket(s) where the playback volume is controlled 
by the volume control 

If you are going to buy a cassette recorder specifically to use with your 
Electron, your supplier will be able to recommend a suitable machine. 
However, most domestic machines can be used with good results, and 
chapter 3 gives details on how to connect a cassette machine to the 
Electron. 

Connecting the Electron to your television set 

Please refer to the diagram. 
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If you are using a monitor rather than a television, then ignore this 
section, and read the section opposite, ‘Connecting the Electron to a 
monitor’; otherwise read on. 

You need to use the long TV lead provided to connect the Electron to 
your television set, and one end of this should be plugged into the aerial 
socket on the back of your television set, having first removed any aerial 
lead already connected. If your television uses its own aerial mounted on 
the set, you will need to find the aerial socket marked AERIAL, or ANT, 
or UHF etc. 

The other end of the lead should be plugged into the socket marked 
‘UHF TV’ on the left hand side of the Electron case. If you look at the 
case, you will see four sockets side by side. If you then look at the bottom 
of the case underneath the sockets, you will see that the name of each 
socket is engraved there. (The ‘UHF TV’ socket is the one on the extreme 
left.) 

Now switch on the television. 

Connecting the Electron to the mains 

The mains adapter which comes with the Electron has one lead which 
should be plugged into the socket on the right hand side of the Electron 
case. This socket is engraved T9V AC POWER IN’. The mains adapter 
itself can be plugged into a domestic 13A socket. 

Having connected the mains adapter to the Electron and to the mains, 
the computer is now ON. As soon as the Electron switches on, you will 
hear a ‘bleep’, and the yellow light on the left hand side of the keyboard 
comes on. If this does not happen, first check that your 13A socket is 
working and is switched on (if it has a switch), and, if it still does not work, 
contact your local dealer. 

Tuning the TV to the Electron 

The Electron should now be connected to the mains adapter and 
switched on, and the TV lead should be connected to your television and 
to the Electron. The next thing to do is to tune your television. 

First of all, turn the TV volume control to minimum - the Electron 
provides its own sound. 
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Most TVs have either a number of push-buttons or a single tuning knob 
for selecting TV stations. 

Push-button tuning 

Choose and select a push-button you don’t normally use, and turn its 
tuning knob as far as you can in one direction, then turn it slowly the other 
way until the following message (or something very similar) appears on 
your television screen: 

Acorn Electron 5 

BASIC 

> 

Single tuning knob 

Turn the tuning knob as far as you can in one direction, then turn it slowly 
in the other direction until something like the message above appears on 
your television screen. 

Connecting the Electron to a monitor 

This section only applies if you are using a monitor rather than a TV. 

Monochrome monitor 

You will need to acquire a special lead which should be available from the 
supplier of the monitor. The end of the lead which plugs into the Electron 
should be inserted into the socket marked ‘VIDEO’ on the left hand side 
of the Electron case. If you look at the bottom of the case, you will see 
that the name of each socket is engraved there. 

Colour (RGB) monitor 

A special lead should be supplied with the RGB monitor to plug into the 
Electron. The end of the lead which plugs into the Electron should be 
inserted into the socket marked ‘RGB’ on the left hand side of the 
Electron case. If you look at the bottom of the case, you will see that the 
name of the socket is engraved there. 


Now try something 

Take a look at the TV screen. If you have already pressed any keys on the 
Electron’s keyboard you will probably see something unintelligible 
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displayedonthe screen. To remove this, press the key on the keyboard 
marked Then press any keys you like on the keyboard - as many 

as you like - you cannot damage the computer whatever you press! The 
little flashing line on the screen is called the CURSOR and is to show you 
where the next character you type will appear. 

If you press the key at any stage, a new line is started and the 

computer will probably display a message on the screen immediately 
underneath what you’ve typed, such as 

Mistake 

or 

Syntax error 

or something else. Don’t take any notice of this; the Electron’s command 
of the English language isn’t quite as good as yours! Later on we will show 
you how to tell the Electron to do things for you by using its own language 
called BASIC. 

If you press a key and hold your finger on it, you will notice that after a 
short time the character displayed on the screen repeats itself over and 
over until you take your finger off the key again. 

If the yellow light to the left of the [JJiSOlI keystill on, then letters of 
the alphabet will appear on the screen as capital (‘upper case’) letters. 

To type s mall lette rs, press the HMUI key and hold it down while you 
press the|»JJ^m| key. The yellow light goes out, and you can now type 
‘lower case’ letters on the screen. 

To get back to capitals, press and again - the keyboard 

is now locked into producing ‘upper case’ letters again. 

Spend some time playing with the keyboard if you aren’t very familiar 
with the layout, and if anything strange happens, just press the 
key. This will clear the screen and you can continue. When you get to 
chapter 5 the keyboard operation is explained in detail. 

The different typefaces used in this book represent the following: 

- Ordinary text appears like this, or like this for emphasis. 

- Text typed into the computer or displayed on the screen appears 

like this or like this. 

- Words like mean that you press the key marked RETURN 

rather than actually type the letters RETURN. 



3 Using a cassette 
recorder 


Introduction 

When you have leamt to write programs that enable the Electron to do 
things for you, it will soon become obvious that you need to make a copy 
of these programs for future use. One very good reason being that when 
you switch off the Electron, everything you typed into the computer is 
forgotten. The Electron gives you the facility of recording your programs 
onto cassettes for future use (just as you might record music). 

Not only this, but you can then play back pre-recorded programs for the 
Electron which other people have written, and make them work on the 
Electron. 

This chapter tells you how to set up your cassette recorder for saving or 
loading programs. These programs will show you some of the things the 
Electron Microcomputer can do. 

First of all, you need to connect a suitable cassette recorder to the 
Electron. 

Connecting a cassette recorder 

The sort of lead you need to connect the Electron to a cassette recorder 
depends on what type of sockets are fitted to your cassette recorder. One 
end of the lead must have a 5-pin or 7-pin DIN plug fitted, and this plugs 
into the socket on the left hand side of the Electron case marked 
‘CASSETTE’ - you will find the name engraved on the bottom of the 
case immediately below the socket. 

The wiring diagram overleaf shows the wiring of the CASSETTE socket on 
the Electron as you look at it from the mating side. 

Your nearest Electron dealer or hi-fi dealer should be able to help 
provide the correct lead if you have any problems, especially if you show 
him the drawing. 
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Cassette interface 

7-pin DEN 
socket 
viewed from 
outside of 
case 

PIN 

1 OUTPUT TO CASSETTE (RECORD) LINKED TO PIN 4 

2 COMMON 

3 INPUT FROM CASSETTE (PLAY) 

4 OUTPUT TO CASSETTE (RECORD) LINKED TO PIN 1 

5 NOT CONNECTED 

6 MOTOR CONTROL SWITCH 

7 MOTOR CONTROL SWITCH 

To help you out of immediate difficulties however: if your cassette 
recorder has a 5-pin DIN socket for record/playback, then you can use a 
standard 5-pin DIN to 5-pin DIN lead between the Electron and the 
cassette recorder. The only disadvantage of this is that the Electron will 
not be able to control the cassette recorder’s motor (assuming that your 
cassette recorder has the facility for externally pausing the tape while it’s 
playing). This facility isn’t absolutely necessary, but it does mean that 
instead of the Electron stopping and starting the tape automatically, you 
will have to do it manually. 

If you find that you are listening to the Introductory Cassette via the 
cassette machine’s internal speaker, you may want to insert a plug into 
the earphone or external loudspeaker socket to stop it - computer 
programs sound like a screeching noise which is not pleasant! If in doubt, 
ask your local hi-fi dealer how to do this on your particular machine. 

Motor control 

If your cassette recorder has a motor control facility and you are using it, 
then you can ignore any messages asking you to stop the tape - this will 
be handled by the Electron automatically. All you need to do is to press 
the PLAY button on the cassette recorder when you first start loading 
the first program (explained in chapter 4) and leave it on. 

If your cassette recorder does not have motor control, then you must stop 
the tape as indicated by the computer. 

You are now ready to use the Introductory Cassette. 




4 The Introductory 
Cassette 


The Introductory Cassette contains lots of interesting demonstration 
programs which are recorded on both sides of the cassette. If you start at 
the beginning of side A and follow the directions in this chapter, the 
computer will take you through each of these programs in turn. When you 
get to the last program on side A, you will be asked to turn the cassette 
over and continue on side B. 

You will notice that the programs on side B start about a third of the way 
along the tape. The reason for this is that there are four extra programs at 
the beginning of side B and at the very end of side A which relate to the 
book Start Programming with the Electron. When you have got more 
familiar with your Electron and start using this book, then rewind the 
tape to the beginning of side B and follow 7 the directions given in the 
book. 

This chapter deals with the demonstration programs only, so insert the 
cassette into your cassette recorder - side A uppermost. 


Adjusting the volume control and loading the first program 

On some cassette recorders, the volume control setting must be adjusted 
first before the Electron can ‘hear’ the programs being played. If this is 
the case for your machine, set the cassette recorder volume control to 
about two-thirds maximum, and the tone control (if fitted) to maximum. 


the 


SHIFT 


key and the 



key ( 

Press 



to ensure that the computer is 
completely reset. Now type the following exactly as it is printed below. 


CHAIN "INTRO" 


To type each quotation mark, hold your finger on the key and 

press the key with the number 2 on it (immediately above the 2 is the " 
character). Make sure you type an ‘O’ and not a zero. 


Then press 


RETURN 


|. If you make a mess of it, don’t worry - just press 


ESCAPE 


and try again. 
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Press PLAY on the cassette recorder, and the tape should start moving. 
The message 

Searching 

should appear on the screen. This means that the computer is looking for 
the program called “INTRO” on the cassette. As soon as it has found it, 
you should see this message displayed on the screen: 

Loading 
INTRO 00 


This means that the program called INTRO has been found, and the 
computer is loading it (copying it) into its memory. The program is 
recorded in ‘blocks’ on the cassette, and the numbers on the screen next 
to INTRO tell you which block is being loaded at the moment. 


If the message above doesn’t appear on the screen after about 30 
seconds from pressingPLAY, then turn the volume control up a bit more, 
and wait for about ten seconds. If there’s still no message, turn it up more 
and keep on until you get a message similar to the one above. 


The two numbers to the right of INTRO will be higher than gg by this time, 


so completely rewind the tape and start again. Press 


BREAK 


and retype 


CHAIN 


"INTRO" 


RETURN 


Now that you have found the right setting for the volume control, there is 
no need to adjust it again. 

Once INTRO has been loaded successfully, four numbers appear to the 
right of the two numbers already there. When this happens, it means that 
the program has finished loading, so unless the Electron has done it for 
you already, stop the tape. If you don’t, then you’ll have to rewind the 
tape back to the end of the INTRO program before the Electron can load 
the next program. If for any reason the program did not load successfully, 
a message will appear telling you to rewind the tape and start again. 

After a short pause, the INTRO program starts running. 

The INTRO program uses some of the colour graphics and sound 
capabilities of the Electron, and also includes an index of the programs 
you are about to see on side A of the Introductory Cassette. 
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Here is a quick guide to the other demonstration programs: 

KEYBOARD 

This program will help you to get to know the Electron’s keyboard. You 
will be asked to type different characters from the keyboard. So that you 
can judge your performance and see how you improve, the computer 
times you! 

SKETCH 

Feeling creative? Here’s a chance to put your artistic talents to use. In the 
centre of the screen there is a cross which you can move wherever you 
like. As the cross moves, it draws a line in the colour of your choice. You 
can also move the cross without drawing a line - rather like lifting your 
pen off the paper - and then carry on. The keys you can use and what they 
do are listed at the bottom of the screen. 

PIANO 

The Electron turns itself into a musical instrument. At the bottom of the 
screen there’s a picture of a piano keyboard with the corresponding keys 
on the Electron keyboard shown. At the top of the screen, the musical 
score appears as you play. 

DODGEMS 

You are in control of a car driving through a maze of roads which each 
contain a row of dots. You must drive along every road and clear the dots 
on them to score the maximum number of points. Unfortunately, there’s 
a computer car coming the other way whose sole purpose in life is to crash 
into you! 

You control the car with five keys which are described at the beginning of 
the game, and these allow your car to: 

- Go left 

- Go right 

- Go up 

- Go down 

- Go faster 

If you are going too fast, you have to turn at every junction unless you 
slow down in time. 

You score one point per dot and one more when they’re all gone. Once 
there are no dots left, a new maze appears and you carry on as before - 
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only this time the computer car travels faster! 

BIORHYTHMS 

This ingenious program plots your ‘biorhythms’ which is the supposed 
balance between your emotional, physical and intellectual states. Some 
people believe that these are regular cycles which show when you are at 
your best and worst physically, emotionally and intellectually. They also 
believe that the rhythms started at birth and can be predicted mathe¬ 
matically. 

All you need to do is enter your date of birth and the date you would like 
the biorhythm chart for- perhaps today, or maybe you have an important 
event coming soon, and you want to find out how you’ll feel on that day. 

The program calculates these cycles from your birth and then displays a 
chart which indicates your state of well-being on the chosen day. 
Biorhythms or no biorhythms, this program demonstrates the com¬ 
puter’s calculation speed (for example, the number of days from your 
birth) and how the computer can be used to display graphical informa¬ 
tion. 

CLOCK 

This program shows that the computer has more of a memory than you 
think. Remember the computer asked you the time in the INTRO 
program? If you typed in the correct time then, you can check it now - 
either as a digital or analogue read-out. You can even reset it if you want. 
As well as demonstrating the Electron’s high resolution graphics, this 
program also shows that the computer is an excellent time-keeper. 

GOMOKU 

Gomoku is a very old board game where two opponents (you and the 
Electron) try to produce a row, column or diagonal with five counters. It 
is really a sophisticated version of noughts and crosses where you must 
plan your moves carefully - there is a very large number of possible 
moves. 

The game starts with a blank screen and the message 

SHALL I START? 

Press Y or N 

After you’ve pressed Y or N, the board appears on the screen, and if you 
let the computer have first go it will have placed its counter somewhere 



The Introductory Cassette 13 


on the board. 


A small cross shows where your counter will be placed. Once you are 


happy with the position for your counter, press 
appears in place of the cross. 


RETURN 


and a counter 


The computer has another go and play continues until one of you 
manages to get an unbroken line of five counters on the board. The 
winning line flashes for a few seconds, and if you want another game, 
press the space bar. 


MESSAGE 

This program tells you to stop the tape (if you haven’t got motor control), 
and continue on side B of the cassette where you will find the programs 
described below. 

PATTERNS 

This program generates kaleidoscopic patterns in colour, and no two 
patterns are ever quite the same. To start a new pattern, press the keys 
marked 1 and 2 in sequence. The pattern itself and its colours are 
randomly selected each time the keys are pressed and serve to 
demonstrate the Electron’s high resolution colour graphics. If you want 
to sit back and watch, press one of the keys for a second or two; the 
computer will continue to generate the patterns until the repeat action of 
the key you pressed runs out. 

MARSLANDER 

You are in command of a spacecraft which you must try to land on a flat 
section of the Martian terrain as gently as possible. Key X rotates the 
craft clockwise, and key Y anticlockwise. The space bar fires the rocket 
motor and makes the spacecraft move in whatever direction it is 
pointing. To land the spacecraft safely, it must be pointing upwards, at a 
speed of less than 50m/s and you must touch down on a flat section of 
Mars. The score depends on your speed when you land, with a possible 
5000 points for landing at 0m/s. After a successful landing, the computer 
will tell you what sort of landing you made, your touch-down speed, how 
much fuel you have left, and ask you to take off for another landing site 
which is more than a specified distance away. On each successful 
landing, you get 30 extra fuel units and your old score is added to your 


new one. 
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BUGZAP 

This program gives you some target practice shooting down a space 
invader. The keys on the keyboard marked Z and X move the launcher, 
and the space bar fires missiles at the space invader. Good luck! 

ISLAND 

This program draws a colour picture of a desert island with palm trees, 
and a moving sea which occasionally becomes turbulent. This program 
demonstrates the use of animation in graphics. 

PLANETS 

This is a very striking example of high resolution colour graphics on the 
Electron, where animation is used to produce a marked three-dimen¬ 
sional effect. 

Loading each program from the cassette 

If you simply follow the instructions on the screen, you will be loading 
each program into the E lectron’s memory one after the other. If you want 
to locate a particular program on the cassette, wind the tape to any point 
before the program you want (a tape counter can be of great help here) 
and type 

CHAIN "XXXX" (where XXXX represents the program name) 

Then press the ElllUHil key. The computer will look through the tape 
until the program name is found, then it will start loading the program, 
and afterwards, run it. 

Alternatively, position the tape just before the beginning of the program 
you want, and type 

CHAIN "" 

Then press the key. The computer will load and run the next 

program it finds on the tape. To help you find the beginning of a program, 
listen to the tape; each program sounds like a screeching noise, and 
between programs you will hear a continuous high-pitched tone. If you 
start loading during the high-pitched tone then you know you’re in the 
right place. 
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There are two important points to bear in mind. The first is that the word 
CHAIN is a command which tells the computer to load the program you 
specify and then to execute it (run it). So in fact the CHAIN command tells 
the computer to do two things. The second point is that when the 
computer is searching for the program you specified, it will still display 
on the screen the name of whatever program is currently playing. This 
should give you an idea of how close you are to the program you want. 
However, remember that whatever program is displayed on the screen, 
the computer isn’t loading it unless you see the word 

Loading 

above the program name. Don’t be fooled into thinking that just because 
a program name appears on the screen, it is being loaded (copied) into 
the Electron’s memory. 

Chapters 9 and 26 give a detailed account of all the facilities made 
available to you by the Electron when recording (saving) and playing 
back (loading) programs to and from cassette. 



5 How to use the 
keyboard 


Introduction 

The Electron keyboard works rather like an ordinary typewriter key¬ 
board. The main difference is that when you press a key, instead of 
letters appearing on a sheet of paper, they appear on your television 
screen. 

The small white flashing line you can see on your TV screen is called the 
CURSOR and it shows where the next character to be typed will appear 
on the screen. 

One thing to bear in mind which the key board doesn’t make obvious - the 
keys which produce the letters of the alphabet 

QWERTYUIOP 
ASDFGHJKL 
ZXCVBNM 


can be made to produce small letters as well as capital letters. 

As you can see, virtually all the keys have more than one character/word 
printed on them - some even have three! There are four keys on the 
keyboard whose purpose is to sort out which one appears on the screen 
when you press a particular key. These are 



1 





there are two of these keys 


/i 


FUNC 


- this is one key, which is normally 'FUNC’ but is 
‘CAPS LK’ when used with the SHIFT key. 


These keys are used in various combinations to give you the character or 
word you want to appear on the screen, and this is described shortly. 


The 


BREAK 


key clears the screen and prepares the computer for 
entering a new program. Any program lines already entered will be 
deleted (but can be recovered by using the OLD command — see chapter 
25). 
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Holding down the Qul key then pressing the key clears the 

screen and restores the computer to how it was when you first switched it 
on. 

The |£I£UJ key is used to interrupt a sequence of events generated by 
the Electron, such as a program listing or program execution etc. 

The key moves the cursor backwards along a line and deletes 

whatever character it finds there. 

Choosing the keyboard characters 

This section tells you how to select all the different characters on the 
keyboard. 

SHIFT and CAPS LK 

Press the |j]|||U key, and hold it down while pressing the IftlifrUll / 
key. If you keep on doing this, you will notice that the yellow light to the 
left of the keyboard goes on and off. 

When the light is on, the keyboard is in ‘CAPS LOCK’, and this means 
that pressing letter keys will give you capital letters, but all other keys 
will give you the lower of the two black characters on the top of the key. 

When the light is off, the keyboard is no longer in ‘CAPS LOCK’ - the 
only difference is that the letter keys will give you small letters when 
pressed. 

SHIFT 

With the yellow light off, press the key, and hold it down while 

you press one of the character keys. All letters appear on the screen as 
capitals, and all the keys with two black characters marked on them make 
the upper character appear on the screen. The keys with three black 
characters marked on them make the top left character appear on the 
screen. 

With the yellow light on, press the |^J|£| key, and hold it down while 
you press one of the character keys. Even though the keyboard is in 
‘CAPS LOCK’, all letters appear on the screen as small letters. 
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FUNC 

A lot of keys have light brown charact ers marked on the front, such as 
GOTO, RUN, f7 etc. Press the / IIMlH key and hold it down: at the same 
time, press the key with PRINT marked °n_LtlL! ront - The worc l PRINT 
appears on the screen. Try pressing the / key with some of the 

other keys with light brown writing on them. 

You probably noticed that the keys marked ‘f0’ to T9’ won’t do anything 
when you press them. This is because they are ‘user definable’ keys 
which means that you can choose what they will do when they are 
pressed. How you define them is described in chapter 24. 

If you have never come across the computer language called ‘BASIC’, 
you may wonder what the point is of being able immediately to display 
these words on your TV screen. The answer is simple; the Electron 
computer understands and uses the ‘BASIC’ language, and these words 
are the most common ‘keywords’ (or commands) in this language, so 
rather than having to keep on typing these out in full, you can simply 
press the / IJTJH key and the relevant character key. This saves a lot of 
time when typing lengthy programs into the computer. 

The arrow keys and the COPY key 

There are five keys in the top right area of the keyboard which have three 
black symbols marked on them (four of the keys have arrows on them, 
and one of them the word QUu)- First of all, here is how to select which 
symbol you want from any of these keys: 

For example, the key marked 


Key by itself selects left arrow (which moves the cursor) 

and key selects A and produces it on the screen 

UJjJJ and key selects^and produces it on the screen 

What the arrow and COPY functions do 

If you press any of the keys marked with arrows, the cursor moves in the 
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direction of the arrow, and leaves a square block where it was before it 
moved. 

If you now press the |£i]j£| key, both the ‘line’ cursor and the ‘block’ 
cursor move across the screen, and every character above the ‘line’ 
cursor is copied to where the ‘block’ cursor is. This is a very useful facility 
for editing programs: the idea is to copy the line with a mistake in it onto a 
fresh line, and correct the mistake(s) while you’re doing it. Editing 
programs using this facility is described in chapter 7. 

Summary 

1. CAPS LOCK off (yellow light off) 

Small letters and bottom black characters 

2. CAPS LOCK on (yellow light on) 

Capital letters, otherwise as above 

3. CAPS LOCK on (yellow light on) m|||| with key 
Small letters and top (left) black characters 

4. CAPS LOCK on or off /EECB with key 

BASIC keywords, as indicated on the front of the keys, are produced 

5. CAPS LOCK on or off fSHI with key 

Selects top right hand character from keys with three black characters 
marked on them. 

Note: See Appendix A foralist of VDU control codes which can be 
generated by pressing Q|3S and some of the other keys on the 
keyboard. 
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The Electron computer, like any computer, has to be told what to do 
before it will do anything for you. The only way you can ‘talk’ to it is by 
typing commands to it on the keyboard, and the Electron tells you what 
you typed by displaying it on the TV screen. 

The Electron understands two languages, one called BASIC and the 
other called Assembly Language. As these are written languages only - in 
other words they are meant to be typed into the computer rather than 
spoken to it - they each have their own special vocabulary and grammar. 

Talking to the computer in Assembly Language is no easy task for the 
beginner so it is discussed in a separate section towards the end of this 
book. From now on, we will be helping you to speak to your computer in 
the language called BASIC. This language consists of a number of words 
or commands. Some of these are printed on your Electron keyboard in 
light brown letters. 


Note that the Electron displays a > sign followed by the flashing cursor. 
This is called a ‘prompt’, and means that the computer is waiting for your 
instructions. Normally the Electron will prompt you when it is waiting for 
you to type something in. The > prompt means that the Electron is 
expecting a BASIC command. 


Press the 


BREAK 


key to clear the screen, and type the following line 


PRINT "HELLO" 


Then press IllillilEI . As soon as you press the key, the 

computer obeys the BASIC command PRINT, and because the rest of the 
line was in quotation marks it displayed the word HELLO on the screen. 

Now type this 


PRINT "I "H" 

PRINT "LEARNING" 
PRINT "BASIC" 



22 introducing commands and programs 


***DON’T FORGET TO PRESS THE KEY AT THE END 

OF EACH LINE!*** 


As you can see, the Electron reads each command and executes it 
immediately after you press the key. You can also type in all 

these commands first AND THEN make the computer execute them 
when you tell it to do so. This is done by putting a number in front of each 
instruction. 

Now type the following 

10 PRINT "HELLO" 

20 PRINT "I'M" 

30 PRINT "LEARNING" 

40 PRINT "BASIC" 

***DON’T FORGET TO PRESS THE KEY AT THE END 

OF EACH LINE!*** 

The computer hasn’t carried out your instructions like it did before, so 
now type 


RUN 


Followed by the llHilKEI key. 

This time the computer has printed your message on the screen all in one 
go. 

Congratulations, you have just run your first program on the Electron 
Microcomputer! 

So a program is simply a collection of numbered instructions. The line 
numbering has two purposes: firstly to tell the computer not to execute 
each line after you have pressed the QloUil key, and secondly to help 
the computer decide in what order it should execute the instructions - 
after you have typed RUN of course. 

The actual numbers you type in can be any numbers you like as long as 
you remember that the computer will execute the program lines in 
numerical order. 

The chapters which now follow serve as an introduction to the Electron 
BASIC language, and how to use the facilities it offers you. The chapter 
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on editing your programs will help you speed up the process of typing in 
programs and making changes to get them working. 


Unlike a typewriter, you don’t need to press the key when what 

you have typed has filled up the current line on the screen - just carry on 
typing. What happens is that the computer starts a new line on the 
screen, and the subsequent characters you type are displayed on the new 
line. Prove this to yourself by typing a lot of characters. 


Remember that pressing the key tells the computer that you 

have reached the end of the command or program line you have just 
typed. If a command, the computer then executes it, and if a program 
line, the computer stores it in its memory. 


What is hexadecimal? 

Once you get more familiar with the Electron, you may come across 
things called ‘hexadecimal’ numbers. Here is a brief explanation of what 
they are. 

Hexadecimal numbers, sometimes called ‘hex’ numbers for short, have 
sixteen separate digits, compared to our decimal numbers which only 
have ten (including the number zero). This is how you count in 
hexadecimal, with the decimal equivalent underneath. 

0 1 2 3 4 5 6 7 8 9ABCDEF10 1I12... 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18.. . 

To show you how to carry on counting in hexadecimal: 

12 13 14 . . . 19 1A IB 1C ID IE IF 20. . . 2F 30... 

3F 40.90 .. . 9F A0 A1 A2 ... AF B0 ... BF C0. 

FF 100 101 .. . etc 

To help you and the Electron tell the difference between decimal 
numbers and hexadecimal numbers, you should always type an sign in 
front of a hexadecimal number. If you don’t, then the computer will 
assume your number to be a decimal. So we can now say &A0 =160 
(hexadecimal A0 is equal to decimal 160). 
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Introduction 

The Electron provides you with a number of very useful facilities for 
laying out, editing and listing your programs. If you haven’t done any pro¬ 
gramming before, here is a brief list of the sort of facilities you will need 
when typing in programs and making them work: 

- Being able to display part or the whole of your program on the screen 
whenever you want to. 

- Correcting mistakes, or editing. 

- Putting comments or notes into the program to help you remember 
what each part of the program is doing. 

- Deleting one or more program lines. 

To start looking at these facilities and how to use them, type in the 
sample program below which we will use to demonstrate the different 
facilities. 

First, press OuliQ clear the screen and reset the computer, then 
type the following, and take care with the punctuation and spaces in the 
last line. 

10 PRINT "GIVE ME A NUMBER BETWEEN ONE AND 
TEN" 

20 INPUT X 
30 Y=2*X 

40 PRINT "TWO TIMES ";X;" IS ";Y 

After typing in the above program, type 

RUN 

When you run this program, the following happens 

line 10 GIVE ME A NUMBER BETWEEN ONE AND TEN appears on the 
screen 

line 20 A question mark appears on the line below, and the computer 
waits for you to type in a number whic h is stored as a variable 
called X. Type in a number and press E5EEEI 
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line 30 The computer multiplies X by 2 and stores the result as a 
variable called Y 

line 40 The following is printed on the screen: TWO TIMES (the number 
you typed in) IS (the result) 

If the program won’t work properly, or you get an error message, press 
and type it in again - you most likely made a mistake when you 
typed it in the first time. 

Listing the program 

When you want to change your program in any way, you will need to 
display the program (or at least the bit you want) on the screen. To do 
this, use the BASIC command LIST. Type 

LIST riilUih'l 

Your program appears immediately underneath the LIST command on 
the screen. 

If you only want to look at one particular line, say line 40, type 

LIST 40 nmuihi 

Line 40 of your program is displayed on the screen. 

To look at a number of consecutive lines, say lines 20 to 40, type 

LIST 20,40 ■dil'lllil 

Lines 20, 30 and 40 appear on the screen. 

If you want to see from the beginning of the program up to a particular 
line, say line 30, type 

LIST ,30 LUIIJHJ 

Lines 10, 20 and 30 appear on the screen. 

If you want to see from a particular line to the end of the program, then 
type 

LIST 20, IsUimiJ 
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Lines 20, 30 and 40 appear on the screen. 

Please refer to chapter 25 for a description of the LISTO commands. 
These commands provide you with even more facilities when listing 
programs. 

Editing programs 

There are three ways of correcting mistakes in programs you have typed. 

One of t hese you have already met in chapter 5: that is, pressing the 
key which moves the cursor back along the current line deleting 
each character as it goes. There is one major drawbacl^othis method - if 
you have finished typing a line and have pressed , you can’t get 

the cursor to go back to t hat line by just pressing the f key. As we 

said before, pressing the key only moves the cursor back along 

the current line, which may not be the one you want to correct. 

Another method is to type in the line again, but with the correction. The 
computer always replaces the old program line with any new version you 
type in. If the line to be corrected is very short, then this method is fine; 
but if the line is long or complicated, then use the third method described 
below. 

Editing with the arrow keys and the COPY key 

Type 

list 

The program appears on the screen, and we are going to use it to try out 
some editing. The following should now be on your screen: 

>LI ST 

10 PRINT "GIVE ME A NUMBER BETWEEN ONE A 
ND TEN" 

20 INPUT X 
30 Y = 2 *X 

40 PRINT "TWO TIMES ";X;" IS ";Y 

> 
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Supposing you want to change the word BETWEEN to FROM in line 10. 

First of all, press the up-arrow key five times. The original cursor position 
under line 40 becomes a white square, and the cursor moves up to line 10. 

Now press the key marked three or four times. The cursor moves 

along line 10, the white square moves along aswell-and line 10 is copied 
underneath line 40. Keep on pressing the key until you have 

copied the word BETWEEN , then stop. Note that if you hold the key down, 
the repeat action allows you to move the cursor quickly across the screen. 
A quick press and release gives you precise control, moving just one 
character position. The following should be on your screen: 

>LI S T 

10 PRINT "GIVE ME A NUMBER BETWE EN_0NE A 
ND TEN" 

20 INPUT X 
30 Y=2*X 

40 PRINT "TWO TIMES ";X;" IS ";Y 
> 10 PRINT "GIVE ME A NUMBER BETWEEN ■ 

Now press until BETWEEN has been deleted from the new line 

10 . 

NOTE THAT THE CURSOR ON THE OLD LINE 10 HASN’T 
MOVED. 

If the cursor isn’t in the right place, ie underneath the space separating 
BETWEEN and ONE, move it there now by using the arrow keys. 

Now type in the word FROM, then press the QH3 key to co Py the rest °f 
line 10 to your new version. 

Press DU5EEEI' The white square disappears, and the cursor goes to the 
start, of a new line. The result should be this: 

>LI ST 

10 PRINT "GIVE ME A NUMBER BETWEEN ONE A 
ND TEN" 
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20 INPUT X 
30 Y =2*X 

40 PRINT "TWO TIMES ";X; M IS *';Y 
10 PRINT "GIVE ME A NUMBER FROM ONE AND 
TEN" 

>_ 

If you LIST the program again, by typing 

list rmum 

you will see that the new line 10 has replaced the old version. Have a go at 
editing line 10 again and change AND to TO. 

There are no restrictions on how much you move the cursor around when 
you’re copying. This means that you can copy bits from lots of different 
lines onto your new line all in one go: wherever you move the cursor to by 
using the arrow keys, you can then copy as much as you like of that line, 
then move the cursor somewhere else and continue copying. 

Deleting lines from your program 

There are two ways of deleting whole lines from your program. 

The first method is to type in the line number of the line you want to 
delete, then press . What you are doing is entering a new 

version of that line into the computer - only with nothing in it. Because 
the computer always replaces a previous version of a line with any new 
version you type in, this method effectively deletes that line number. 

For example, to delete line 10 of the program, type 

10 

Now list the program by typing 

LIST 

And you will see that line 10 has been deleted. Now type the original line 
10 again so that it goes back into your program. 
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The second method of deleting program lines is to use the DELETE 
command. This command allows you to delete a number of consecutive 
lines. 

To do this, type DELETE, then type the first line number to be deleted, 
then a comma, followed by the last line to be deleted. The following 
examples will help you understand, but before typing them into the 
computer, remember that they will in fact delete parts of your program, 
so afterwards you will need to type the deleted lines again to restore your 
program! 

First of all, list your program so that you can see it on the screen. You 
should have lines 10, 20, 30 and 40. If not, then replace the missing ones 
(copy them from the program listing at the beginning of this chapter). 

To delete lines 10, 20 and 30, type 


DELETE 10,30 


RETURN 


To delete all lines from the beginning of the program to a particular line 
number, type 0 followed by a comma followed by the last line to be 
deleted. For example, to delete lines 10, 20 and 30, type 


DELETE 0,30 


RETURN 


To delete all lines from a particular line to the end of the program, the 
numbers to enter after the DELETE command should be the first line 
number to be deleted, then a comma and then any number which you 
know to be equal to or greater than the last line number of the program. 
For example, to delete line 20 onwards, type 


DELETE 20,100 


RETURN 


Inserting new lines into your program 

First of all, list your program (if you haven’t deleted it all!) and type in any 
lines which may be missing. 

Having typed in the first attempt of a program, executed it by using the 
RUN command, and changed or deleted lines as necessary to make the 
program work, you may want to insert new lines. You will then see how 
important it was to leave plenty of unused line numbers between the 
original lines in your program. To insert new lines, decide when you want 



30 Editing programs 


the new line to be executed by the computer when it nans the program, 
then choose a suitable line number. For example, to insert a line which 
makes the computer print another message underneath GIVE ME A 
NUMBER FROM ONE TO TEN, you will need to insert a new line 
somewhere between lines 10 and 20. Let’s choose 15; this still leaves 
some room either side for any more new lines, so now type 


15 PRINT 


"NICE DAY ISN'T IT" 


RETURN 


Now list the program, and you will see that the new line appears in the 
listing. The listing should look like this 


10 PRINT "GIVE ME A NUMBER FROM ONE TO TEN" 
15 PRINT "NICE DAY ISN'T IT" 

20 INPUT X 
30 Y=2*X 

40 PRINT "TWO TIMES ";X;" IS ";Y 


Make the computer execute the program by typing 


RETURN 


and type a number for it to multiply by two. Remember that the 
computer is expecting a numeral and will not recognise letters. This is 
because our little program would need some more lines adding to it 
before the.computer would recognise THREE instead of 3, or TEN 
instead of 10. 


Renumbering the program 

There may be occasions when you want to change the line numbers of a 
program but without changing the order in which they are executed by 
the computer. The command which does this is RENUMBER. This facility 
is especially useful when you want to insert say 25 new program lines 
between lines 10 and 20 in your existing program. 

You can specify two numbers after typing the RENUMBER command. 
The first number tells the computer what you want the first program line 
number to be changed to, and the second number tells the computer how 
much to add to each line number to get the next one. 

For example 
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RENUMBER 100,20 


RETURN 


will renumber the first line as line 100, and the remaining lines will be 
numbered 120, 140, 160, and so on. 

If you leave out the second number in the RENUMBER command, the 
computer will automatically change the second line number to ten more 
than the first, and then carry on through the listing. So if you had a 
program with line numbers 


23 PRINT 

24 PRINT 
26 PRINT 
30 PRINT 


"The Electron" 
"Microcomputer" 

"wi11 do" 

"many things for you 


and type 


RENUMBER 


100 


RETURN 


listing the program will give 


100 PRINT "The Electron" 

110 PRINT "Microcomputer" 

120 PRINT "wi ll do" 

130 PRINT "many things for you 


If you simply type 


RENUMBER 


RETURN 


then your program lines will be renumbered 10, 20,30, 40,50 and so on. 


Getting the computer to number each program line 

Instead of typing line numbers at the beginning of each new program line, 
you can get the computer to do this for you by using the command AUTO. 

If you type 


AUTO 


RETURN 


vou will see that the computer will print the number 10 on the line below. 
You can then type the first program line, press 


RETURN 


at the end, and 



32 Editing programs 


the number 20 appears on the next line - and so on. When you want to 
switch off this automatic line numbering, press 


ESCAPE 


If you don’t want to start the program at line 10, and want a different 
number of spare lines between each of your program lines, then you can 
type in two numbers - separated by a comma - after the AUTO command. 
For example, if you type 


AUTO 400,15 


RETURN 


the program line numbers will come out as 400, 415, 430, 445 and so on. 


Now press 


BREAK 


|, and retype the example program we were using 
previously using the AUTO facility. Start the program numbering at 200 
and continue in steps of 50. 


Putting notes into your programs 

When typing programs, especially long ones, it is a good idea to insert 
comments here and there to tell you what each part of the program is 
doing. This is done by using the REM command. All REM does is tell the 
computer to ignore the rest of the line when it executes the program, but 
your comments will still appear in the program listing when you give the 
command LIST. 

For example, we could insert a comment at the beginning of our example 
program to tell us what the purpose of the program is, like ‘This program 
doubles numbers’. To insert this into the program listing, first type 


RETURN 


to get a listing of the program. Then choose a line number less than the 
first program line, say 5. Now type 


5 REM This program doubles 


number s 


RETURN 


If you list the program, then run it, you will see that the comment in line 5 
appears in the listing, but is ignored when the program is executed. 


Retrieving a program and starting a new one 

If you press the ldil?:l[l key for any reason, the program you have typed 
in so far gets ‘lost’. To get it back again, type 


OLD 


RETURN 
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If you want to start a new program, make sure that any program already 
stored in the computer has been deleted. In other words, type 

LIST IdlUJiU 

and if a program appears, then delete it by typing 

NEW IdlUlliJ 

You can now enter your new program, and the old one is forgotten. 



Listing long programs 

When listing very large programs, which won’t fit on the screen all in one 
go, the beginning of the listing will disappear off the top of thescreen. 
There a re two ways of getting round this: one way is to press ant * 

together as soon as you have typed 


LIST CHI 


The effect of this is to halt th e displa yed listing on the screen. Taking 
your finger off either or allows the listing to continue, and 

this enables you to ‘step’ through chunks of the listing. 

The other method is to put the Electron into ‘paged mode’. Press 
N to get into ‘paged mode’, then list the program. The listing stops as 
soon as it has fill ed the w hole screen. To display the next ‘screenful’ of 
listing, press the QyQj key. 

Press QQ1 0 to get out of paged mode. 


^_,*% 
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Introduction 

Having seen something of what the Electron can do, and having got used 
to typing on the keyboard, it’s now your turn to tell the Electron to do 
things. Because the computer does exactly what it is told, remember to 
type in the examples given exactly as they appear in this chapter. You’ll 
find that you can sometimes get away with adding an extra space here 
and there or leaving one out, but rather wait until you are more familiar 
with the Electron BASIC language before experimenting! After you have 
typed in each program, type 


RETURN 


to execute it. If the program doesn’t appear to work, the computer may 
help you by displaying an error m essage, and telling you in which line the 
mistake appears. Press and list the program as described in the 

chapter on editing. Make the necessary alterations, then run the program 
again. 


Before you start, press the key marked 123233 on the keyboard. This 
will get the computer ready for you, and also start you off with an empty 
screen. 


PERSIAN 

This program produces a pattern by drawing hundreds of lines. Random 
colours are selected by lines 40 and 50. Line 60 moves the origin (middle) 
of the picture to the centre of the screen. The program stops after a while, 
so run it again to repeat the patterns. 

10 REM PERSIAN 
20 MODE 1 
30 D% = 4 

40 VDU 19,2,RND(3)+1,0,0,0, 

50 VDU 19,3,RND(3)+4,0,0,0 
60 VDU 29,640;512; 

70 J1%=0 

80 FOR K% = 500 TO 380 STEP -40 
90 REPEAT J 2% = RND(3) : UNTIL J2%<> J1Z 
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100 J1%=J 2% 

110 GCOL 3,J1% 

120 FOR I% = -K % TO KX STEP 0% 
130 MOVE K%,I% 

140 DRAW -K%,-I% 

150 MOVE I%,-K% 

160 DRAW -I%,K% 

170 NEXT 
180 NEXT 


POLYGON 

This program draws polygons (many sided shapes) in random colours. 
Lines 90 to 150 select a random place on the screen which will be the 
centre (origin) of the next shape. 

Lines 170 to 250 calculate the X and Y coordinates of each comer of the 
polygon and store the values in two ‘arrays’ for future use. 

Lines 220 and 160 fill the shape with black triangles which make it 
appear as if the new polygon is in front of the older ones. 

Lines 260 to 310 draw all the lines that make up the polygon. 

Lines 30 to 50 set the actual colours of logical colours 1, 2 and 3 to red, 
blue and yellow. You can change these to use other colours if you like. 
Unlike the PERSIAN program, this one carries o n and on until you stop 


it yourself. To do this, either press 


ESCAPE 133 BREAK 


10 

REM POLYGON 



20 

MODE 1 



30 

VDU 19,1,1, 

0,0 

,0 

40 

VDU 19,2,4, 

0,0 

,0 

50 

VDU 19,3,3, 

0,0 

,0 

60 

DIM XC10) 



70 

DIM Y ( 10) 



80 

FOR C=1 TO 

2500 

90 

xo rigin = RND 

(1200) 

100 

y or i g i r»=RND 

(1000) 

110 

VDU 29,xori 

g i n 

; y o r i g i n; 

120 

radius=RND( 

300) + 50 

130 

sides=RND(8)+2 


140 

MOVE radius 

,0 


150 

MOVE 10,10 



160 

GCOL 0,0 



170 

FOR SID E = 1 

TO 

sides 
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180 a ng l e =(SIDE-1)*2*PI/sides 
190 X(S10E) = rad1us*C0S(angLe) 
200 Y(SIDE)=radius*SINCangLe) 
210 MOVE 0,0 

220 PLOT 85,X($IDE),Y (SIDE) 

230 NEXT SIDE 

240 MOVE 0,0 

250 PLOT 85,radius,0 

260 GCOL 0,RND(3) 

270 FOR SIDE=1 TO sides 
280 FOR Line=$IDE TO sides 
290 MOVE X(SIDE),Y (SIDE) 

300 DRAW X (l ine),Y(l ine) 

310 NEXT Line 

320 NEXT SIDE 

330 NEXT C 


DRAW 

This program is a simpler version of the SKETCH program on the 
Introductory Cassette. The main part of the program is between lines 20 
and 220, and two procedures are called from here. 

Lines 240 to 290 print the instructions at the bottom of the screen. 
Lines 320 to 360 limit the graphics area you can draw in, and contain the 
DRAW instruction. 

Lines 130 to 200 define which keys on the keyboard are ‘drawing’ keys, 
and set the values for X and Y for each key. These values are used later 
on by line 360. 

Note that line 40 tur ns the cu rsor off, so when you’ve finished drawing 
masterpieces, press 1< and type 


VDU 23,1,1; 0; 0; 0; 


RETURN 


Alternatively, just press 


BREAK 


10 REM DRAW 
20 M0DE1 
30 PROCKEY 

40 VDU 23,1,0;0;0;0; 
50 GCOL 0,1 
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60 VDU 19,1,2,0,0,0 
90 X = 640 
100 Y = 51 2 

110 MOVE X,Y:D R AW X,Y 

120 REPEAT 

130 L=INKEY(-98) 

140 R=INK EY(-67) 

1 50 U = INK EY(-73) 

160 D=INKEY(-105) 

170 IF L=-1 THEN X=X-4:PROCDRAW(X,Y) 

180 IF R =-1 THEN X = X + 4:PROCDRAW(X,Y) 

190 IF U = -1 THEN Y=Y+4:PROCDRAW ( X,Y) 

200 IF D--1 THEN Y=Y-4:PROCDRAW(X,Y) 

210 UNTIL FALSE 
220 END 

230 DEF PROCKEY 

240 PRINT TAB(0,25) "Your Drawing keys are: 
250 PRINT TAB(0,26) "Z or z = Left" 

260 PRINT TAB(0,27) "X or x = Right" 

270 PRINT TAB(0,38) "* or: = Up" 

280 PRINT T AB(0,29)"? or / = Down" 

290 PRINT TAB(0,30) "Press two keys for a d 
iagonal" 

300 ENDPROC 

310 DEF PROCDRAW(X,Y) 

320 IF X<0 THEN X=0 
330 IF X>1279 THEN X=1279 
340 IF Y <2 5 0 THEN Y= 250 
350 IF Y>1023 THEN Y=1023 
360 DRAW X,Y 
370 ENDPROC 



9 Recording programs 
on cassette 


As you have seen, the Introductory Cassette has a number of programs 
stored on it. You can record programs you have typed into the Electron 
onto cassette for future use. This is very useful for transferring other 
people’s programs from their cassette onto yours; for example, you might 
want to copy one particular program on the Introductory Cassette onto 
another cassette. Before you make any cassette copies of any programs, 
be sure that you are free to do so. The company or person who wrote the 
program may own the copyright to that program, in which case, written 
permission must first be applied for. 

The main thing to remember when you record programs is where the 
program that you’ve recorded can be found on the cassette, otherwise 
you will spend a lot of time searching. We strongly advise you to keep a 
piece of paper with each cassette, and to write down the name of each 
program and the tape counter position where it begins and ends. Bear in 
mind that when you record a program, it will record over the top of 
anything already on the tape; this is useful for erasing old programs you 
no longer need, but fatal if you record over the top of one you want to 
keep! 

Most short programs will only move the cassette tape counter on 30 or 40 
positions, but try to spread the programs over the length of the cassette. 
For example, record the first program at 000, the second at 100, the next 
at 200 and so on. This will make them easy to find, and will reduce 
the chances of overlapping recordings. The quickest way to find out if 
there’s a program at a particular point on the cassette is to play it back 
and listen to the cassette machine if you can. If there is a high pitched 
whistling noise, it means that a program is just about to start or just 
finishing. If you hear a screeching noise, you are listening to a program. 

One final point-when recording a program at the beginning of a cassette, 
wind the tape by hand until the clear plastic tape ‘leader’ is no longer 
visible. 


Saving (recording) a program on cassette 

Once you have typed a program into the Electron, then do the following 
to save it: 
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Insert the cassette into the cassette recorder. 

Set the tape counter to 000 when the tape is fully re-wound. 
Type 


SAVE 


"MYPROG" 


RETURN 


The message 


RECORD then RETURN 


appears on the screen. 


Fast forward the cassette to the place where you want to record the 
program - this will be 100, 200 or 300 etc on the tape counter. Note 
that if you have cassette motor control, you cannot wind the tape unless 
you have executed a SAVE, LOAD or *CAT command (see below for * CAT). 


Start recording on the cassette machine, then press 
Electron. 


RETURN 


on the 


If you want to give up at any time, press 


ESCAPE 


While the program is being saved on the cassette, the name of the 
program, which is MYPROG appeal's on the screen along with some 
numbers. This means everything is going OK. When the computer is 
finished, the > will reappear, and the tape will stop automatically. If you 
don’t have cassette motor control then the tape will carry on, and you will 
have to press the STOP button on the cassette recorder after the > 
reappears. 


Checking a recording 

To check that the program is really on the cassette use the *CAT 
command described later in this chapter. If the recording went wrong for 
any reason, then just re-record it. 

In the example above, the program was called MYPROG, but you can 
make up any name you like - as long as it contains ten letters or less. 


Loading a program from cassette 

To load a program on cassette into the Electron’s memory, type 
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LOAD 


“MYPROG" 


RETURN 


The message 


Searching 

will appear. Rewind the cassette to just before the beginning of the 
program, using the tape counter to help you get there. 

Check that the volume and tone controls are set correctly. If you are 
unsure about this, turn to chapter 3. 

Press the PLAY button on the cassette recorder. 

If the computer finds a program other than the one you asked for, it will 
display its name on the screen but won’t load it. As soon as the computer 
finds the beginning of your program called MYPROG, the message 

Loading 


will appear, and this tells you the computer is now loading that program. 

When the program is loaded, the computer will print the > prompt on the 
screen, and will automatically stop the tape if you have motor control. If 
you haven’t, then press the STOP button. 

Now the program is in the computer’s memory, type 


RETURN 


and the computer executes the program. If you have read the chapter on 
the Introductory Cassette, you probably remember that we were using a 
different command to load the tape. This is the CHAIN command, and 
what it does is to tell the computer to first LOAD the program and then 
RUN it immediately afterwards. So if you type 


CHAIN 


“MYPROG" 


RETURN 


this will save you having to type RUN after the program has loaded. 

LOADING AND SAVING SHOULD NORMALLY BE DONE IN 
MODE 4, 5 OR 6. 



Recording programs on cassette 41 


Cataloguing the tape 

To find out what programs are on the tape, type 


RETURN 


then play the tape (from the beginning if you want). Better still, keep a 
record of what is on the tape because cataloguing the tape takes a long 
time. However, cataloguing the tape also lets the computer verify the 
information recorded. If there are any errors in the data on the tape, an 
error message will appear on the screen, and the cataloguing continues. 


What the numbers mean 

A typical catalogue might look like this 


MY PROG 

00 

0084 

GAME 1 

08 

0 88 E 

GAME 2 

0 A 

0 AB A 

f r ed 

25 

2545 


The program name (or ‘filename’) is followed by two ‘hexadecimal’ 
numbers which give the ‘block’ number. As described in chapter 4, each 
program is recorded as a series of ‘blocks’. See chapter 6 for an 
explanation of hexadecimal numbers. 

The last number on the line gives the ‘length’ of the file. 


Escape 

If you wa nt to stop in the middle of a LOAD, CHAIN or SAVE, press 
. You will probably get a 


ESCAPE 


Bad P rog ram 

error appear on the screen. To get rid of this, type 


NEW 


RETURN 


For more information about using cassettes for storing programs, please 
turn to chapter 26. 




10 The FUNC key and 
BASIC keywords 


FUNC 


key to 


As mentioned in chapter 5 on the Electron keyboard, the_ 

the left of the keyboard may be used with many of the other keys to print 
comple te BASIC keywords on the screen. For example, if you press 
L the keyword LIST appears. Each key used together with 
will give a keyword as follows: 


FUNC 


FUNC 


A AUTO 
B RENUMBER 
C COLOUR 
D DRAW 
E ELSE 
F FOR 
G GOTO 
H DEG 
I INPUT 
J RAD 
K CHAIN 
L LIST 
M MODE 
N NEXT 
0 OLD -J 
P PLOT 
Q LOCAL 
R RUN -J 
S STEP 
T THEN 
U UNTIL 

V VDU 

W RESTORE 
X PROC 

Y REPEAT 
Z END 

, LOAD 
SAVE 

/ PRINT 
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OLD and RUN incorporate 


RETURN 


, thereby issuing a direct command. 


If you press 


FUNC 


R then the current program (if any) will run. 


may also be used with the numeric keys, which may be 
programmed to give any string you choose (see chapter 24). 


FUNC 


The action of 


FUNC 


with all the keys can be altered using operating 


system call *FX226 and *FX227 (see Appendix D). 


Another way in which to cut down on typing is to use the abbreviations 
given in the BASIC keyword alphabetical reference section in chapter 

25 . 



11 \kr iables and 
expressions 


What is a variable? 

A variable is piece of memory which is given a name, like Fred or Number 
or X or Y or virtually anything you want, and this memory is set aside for 
storing information. It is rather like a box where you and the computer 
can put useful items of information until they are needed at a later stage. 
All the computer has to be told is what the box is called, and what kind of 
information it can expect to find inside. Not only that, but the contents of 
a box can be changed at any time; so the computer can go to the box to 
store information, retrieve it, use it, change it, then put it back inside 
again as many times as you instruct the computer to do so. 

There are three types of ‘boxes' or variables which the computer can use, 
and these are used to store three types of information. Briefly, these are: 

- A ‘real’ variable, which can store numbers or fractions, eg 123.654. 

- An ‘integer’ variable, which can store only whole numbers, eg 123. 

- A ‘string’ variable, which can store ‘strings’ of characters such as 
words. 

Each type is distinguished by the last char acter of the variable name. A 
name by itself, like BERT, signifies a real variable, BERT% an integer 
variable and BERT$ a string variable. 


Real variables 


Press 


BREAK 


and type the following program (the line numbers are 


shown, but you will not need to type them if you are using AUTO). 


>10 PRINT 3+2,3-2,3*2,3/2 
>20 A=3 
>30 B = 2 

>40 PRINT A+B,A-B,A*B,A/B 
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If you run this program, you will see that the numbers 

5 1 6 1.5 

5 1 6 1-5 

are printed on the screen. The first row shows the results of the 
calculations performed by the PRINT instruction. The second row again 
shows the results, except that this was arrived at by lines 20 to 40 which 
use real variables. 

Line 20 tells the computer that there is a variable in the program called 
A, and sets its current value to 3. 

Line 30 tells the computer that there is another variable called B, and its 
current value is 2. Now that the computer is aware of these two variables, 
you can tell it to use them in calculations. Thus in line 40, the computer 
looks for the number stored in each variable, performs the necessary 
calculations, and the PRINT instruction prints the results on the screen 
just like it did for line 10, 


Operators and expressions 

Things like 3 + 2, A*B, (FRED - 4)*B are called expressions. In general, 
an expression is a sequence of numbers and variables together with 
mathematical symbols like +, *, /. These symbols, which are called the 
‘arithmetic operators’, have their normal mathematical meaning, except 
that in BASIC, * is used for ‘multiply’ and / for ‘divide’. 

Here is a list of the arithmetic symbols or ‘operators’ used in Electron 
BASIC: 

+ addition 
- subtraction 
* multiplication 
/ division 
A raise to the power 
decimal point 

For a description of operator precedence, see chapter 12. 
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Rules for variable names 

The rules for naming variables are: 

- There must be no spaces in the name. 

- The name must start with a letter. 

- There must be no punctuation marks in the name and no arithmetic 
operators. Underline characters may be used. 

- The name must not begin with a BASIC keyword (such as LIST or 
RUN). 

All the following names are acceptable: 

X = 6.6 

SMALL = -30 


small = -60 
xy = 4*3 
height6 = 5/11 
WiLliam 1 = 1066 


space_rocket_speed = 25.000 


Note that capital and small letters are regarded as different by Electron 
BASIC , so that SMALL and small are two different variables. Underlines 
take the place of spaces, which are not allowed. 

The following are not acceptable: 


6teen = 16 
TOTAL = 77 
see-saw = 16 
LOW LINE = 3.333 
How! = 1 


(begins with a number) 
(begins with TO) 

(contains a minus sign) 
(contains a space) 

(contains punctuation mark) 
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A variable does not have to be specified in terms of numbers; it may be 
specified in terms of other variables, or a mixture of variables and 
numbers. A statement of the form ‘variable = expression’ is called an 
assignment statement : it assigns the value of the expression to the 
variable. For example: 

X = Y 

Monday = Tomorrow 
AGE = HEIGHT - 100 
TALL = TALL + 1 

The last assignment of this group is very common. It has the effect of 
increasing the value of the variable TALL by 1. It is read as ‘Add 1 to the 
number contained in TALL, and store it in TALL again’. 


Integer variables 

The variables described so far in this chapter are called real variables. 
This means that they can represent both whole numbers (integers) and 
decimal fractions. There are variables called integer variables which can 
be used on the Electron, and these are used for storing only whole 
numbers. They are signified by the % symbol after the variable name. For 
example, 

SC 0RE% = 20 
HourX = 3600 
Z% = -747 


A% to Z% 

The 26 integer variables A% to Z% are called resident integer variables , 
because they are not cleared when the program is RUN, or when NEW or 
| is used. This means that values can be passed from one program 

to another. They also have special uses when you come to look at 
Assembly Language programming (see chapter 29). 
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Real versus integer variables 

The reasons for using integer variables are: 

- They occupy slightly less memory than do real variables. 

- They are absolutely accurate provided you do not let them get out of 
range. Real variables are only accurate to nine figures. 

- They are much quicker for the computer to process and carry out 
arithmetic functions. 

However: 

- Decimal fractions can only be stored in real variables. 

- Much larger and much smaller numbers can be stored in real 
variables. Real numbers can have values of up to approximately 
170,000,000,000,000,000,000,000,000,000,000,000,000 or 1.7 X 10™ 
(though they are only accurate to the first nine numbers or nine 
significant figures). 

The range and accuracy of real and integer variables are shown in the 

following table: 



Integer 

Real 

Example 

64 

1.732 

Typical variables 

A% 

A 

Maximum size 

2,147,483,647 

1.7X10™ 

Accuracy 

absolute 

9 sig figs 

Stored in 

32 bits 

40 bits 


DIV and MOD 

There are two special arithmetic operators which give integer results. 
These are called DIV and MOD. 

DIV is an integer division function. It gives the whole number part of a 
division, for example: 9 DIV 2 is 4, 10,5 DIV 3 is 3. 

When decimal numbers are used, such as in the second example above, 
the computer truncates the number (meaning that it ignores the decimal 
part) before it carries out the division: 8.1 DIV 2.9 is 4. 

MOD stands for modulo, and is used to give the remainder after an 
integer division. For example: 9 MOD 2 is 1,17 MOD 7 is 3. 
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Once again, decimal numbers are truncated before the division takes 
place. For example: 16.1 MOD 3.8 is 1. 

The TIME integer variable 

There is also a special integer variable, resident in the computer, which is 
called TIME. TIME is an elapsed-time clock: it ticks away in hundredths 
of a second. Every 1/100 of a second its value increases by 1, and it is 
used for timing programs. 

10 T%=TIME 
20 PRINT TIME -T% 

will print the time taken to execute one line of program, in hundredths of 
a second. 

TIME may be assigned a starting value, or it can be zeroed, just as any 
other variable: 

TIME = 0 

TIME runs continuously for as long as the computer remains switched 
on. You will understand better how to use it when you look at some of the 
programs later in the book. 

String variables 

You have seen that a variable is a name which can be assigned a value 
either directly or by an assignment statement. The computer will store 
this value in its memory as a binary number - a series of zeros and ones. 
Characters are also stored in the computer as binary numbers, and each 
character has a code. This code is called ASCII, standing for ‘American 
Standard Code for Information Interchange’. If you look in Appendix F, 
you will see a table of ASCII codes showing all the letters, symbols, and 
numbers each with their corresponding ASCII code number. 

When you use the PRINT instruction to put a message on the screen, as 
for example: 


PRINT "ASCII" 
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the quotation marks each side of the message tell the computer that what 
is in between them is a string of characters and not a variable. So each of 
the characters in the message ‘ASCII’ is stored as a binary number, 
corresponding to 65, 83, 67, 73, 73 in decimal, as you can see from the 
ASCII chart in Appendix F. 

There are special variables, called string variables, which hold charact¬ 
ers as opposed to numbers. String variables are signified by a $ sign after 
the variable name. So we can say: 

A$ = "AC ORN" 
f i s h $ = “TWO COD'* 

Birthdays = "Monday 23rd August" 

It is very important for you to understand how this last assignment is 
stored. Notice that the string contains a number, 23. Because of the 
quotation marks this number is not stored as 23 in binary, but as the 
ASCII code for 2 followed by the ASCII code for 3. This knowledge is 
very useful when you come to manipulate strings using their code values. 

For example: 

PRINT "23" 

and 

PRINT 23 

both have the same effect. 

But 

PRINT "23*6" 

and 

PRINT 23*6 

show the different ways in which numbers and strings are stored. As you 
can see from the ASCII table in Appendix F, every number has its own 
ASCII code. 

You can use the computer to find out the ASCII code of a character. 
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PRINT ASC "Q" 

will give the ASCII value of Q which is 81. 

The opposite function is given by 

PRINT C H R $ 81 

which converts the ASCII code 81 into its corresponding character which 
is Q. 

Even a space has an ASCII code. 

PRINT ASC " " 
gives 32. 

And nothing at all (an empty string): 

PRINT ASC "" 

gives — 1. 

This is not an ASCII value, but is conveniently different from all the 
others as to be easily distinguishable. 

The instruction 

PRINT C HR $ 81 

has an equivalent which is easier to type: 

VDU 81 

is identical, so VDU 81 gives the letter Q. 

Commands operating on strings 

LEN 

String variables may be up to 255 characters long, and there is an 
instruction LEN, which gives the length of a string-the number of 
characters it contains. 
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PRINT LEN "ABCDE F" 

will print 6 on the screen. 
Similarly, 


A$ = "S 0 S M 
PRINT LEN A $ 

will print 5 (because a space is a character). 

Linking strings 

Two or more strings may be linked together by using the ‘+’ operator, 
which apart from its arithmetic use, can simply link strings. The following 
program is an example of this. 


10 

A$ 

— 

"I " 

20 

B $ 

= 

"LEARNING 1 * 

30 

c$ 

= 

"BASIC" 

40 

D $ 


AS + B$ + C$ 

50 

PRI 

NT 

D $ 

>RUN 



I *1 

MLEA 

RN 

INGBASIC 


LEFT$, RIGHT$, MID$ 

Not surprisingly, if the computer can link strings it can also disassemble 
a string to make smaller ones, using LEFT$, R!GHT$, and MID$. 


10 

AS = 

"INEQUITABLE 

20 

B $ = 

LEFT$(A$,2) 

30 

c$ = 

RIGHT$(A$,5) 

40 

D $ = 

MI0$(A$,3,4) 

50 

PRINT 

BS 

60 

PRINT 

C$ 

70 

PRINT 

D S 


>RUN 

IN 

TABLE 

EQUI 
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Notice how the three functions LEFT$, RIGHTS, and MID$ are used: 

LEFTS (AS,2) copies the first two characters of string A$. In the program, 
these two characters are copied into B$. 

RIGHTS (AS.5) copies the last five characters of string A$. 

MIDS (AS,3,4) copies four characters from string A$, beginning at the 
third character from the left. 

VAL, EVAL, STR$ 

There are three more string operating functions which convert to or from 
numbers: VAL, EVAL, and STRS. 

10 X$ = “57/7 * SIN . 6 M 
20 PRINT VAL X$ 

30 PRINT EVAL X$ 

When you run this program, VAL X$ gives the number with which the 
string X$ begins, in this case 57. If the string does not begin with a 
number then VAL returns the value 0. 

EVAL X$ evaluates the string as if it were a numeric function, giving in 
this case 4.597803. EVAL will also evaluate variables in strings, provided 
these variables have been assigned earlier in the program. 

Sometimes you need to turn a number into a string, and this is done by 
using the instruction STR$. 

10 A = 45 : B = 30 
20 A$ = STR$ (A) 

30 B$ = S TR$ (B) 

40 PRINT A + B 
50 PRINT A$ + B$ 

IN STR 

Another useful string function is IN STR (standing for IN STRING) which 
will compare two strings and tell you whether one of these strings is 
contained within the other, and at what position. 

For example 


"I 

"I 


NEQUITABLE 


If 



10 A$ 
20 B$ 
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30 1 = INSTR(A$,B$,2) 

40 PRINT Z 

This program shows that INSTR returns the position at which B$ is the 
same as A$. We can start the INSTR comparison at any point along the 
string. 

This program starts the comparison at the second character of string A$, 
and therefore indicates the second ‘I’ at position 6. If INSTR is used and 
there is no similarity between the strings, a 0 is given. 

STRING$ 

The last string function, STRINGS, is used when you want to make a long 
string which consists of repeated units. For example, if you wish to use a 
string to print a border made up from *-*-*-*- etc then it is easier to use 
the STRINGS function than to type all the characters. 

10 A$ = ,, *- M 

20 B$ =STRING$(20,A$) 

30 PRINT B$ 

> RUN 

*—*-*-*-*-* — *- *- ★ — *- *-*-*-*-*-*-* — 

The string B$ is made up from 20 copies of the string A$. 


Comparison table of variables 


Finally, here is the complete comparison table for integer, real, and string 
variables: 



Integer 

Real 

String 

Example 

810 

1.141 

“WORDS” 

Typical variables 

A% 

A 

A$ 

Maximum size 

2,147,483,647 

1.7 X 10 38 

255 characters 

Accuracy 

absolute 

9 sig figs 

— 

Stored in 

32 bits 

40 bits 

ASCII values 
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When a mathematical or logical expression is being evaluated, all the 
operators (H - , *,01V etc) are given a priority of from 1 to 7. Priority 1 
operators are those acted upon first, and priority 7 last. 

Here is the complete list: 


Priority 


Operator 

1 

— 

Unary' minus 


+ 

Unary plus 


NOT 

Logical NOT 


FN 

Functions 


0 

Brackets 


?!$ 

Indirection operators 

2 

A 

Raise to the power 

3 

* 

Multiplication 


/ 

Division 


DIV 

Integer division 


MOD 

Integer remainder 

4 

+ 

Addition 


— 

Subtraction 

5 

— 

Equal to 


<> 

Not equal to 


< 

Less than 


> 

Greater than 


<= 

Less than or equal to 


>= 

Greater than or equal to 

6 

AND 

Logical and bitwise AND 

7 

OR 

Logical and bitwise OR 


EOR 

Logical and bitwise Exclusive OR 


Operators with the same priority are executed left to right, as they 
appear in the expression. For example, 22 MOD 3/7 is evaluated as (22 
MOD 3)/7. All priorities may be overridden by using brackets. 
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Arrays are groups of variables. An array variable has a name, just as any 
other, and it also has one or more subscripts. A subscript is a number, 
and an array variable is numbered according to its position in the array. 
For example, m is the first variable in the array named A, and A(1) is the 
second variable. The computer must be told how many variables you 
wish to use in the array, and this is done by using a DIM instruction: 

DIM A(9) 

allocates space in the computer’s memory for ten variables, each called 
A, but each having a different subscript. 

These variables are A(0),A(1), A(2) . .. A(8), A(9). Each one of these 
variables may be individually assigned, just like any ordinary variable. 

String arrays may also be used. 

DIM A$ (9) 

allocates space for ten string variables - each of up to 255 characters. 

The examples shown above are one dimensional arrays-you can think of 
them as a line containing a number of variables, subscripted from 0 to 9 
in sequence. Two dimensional arrays can be thought of as the printing on 
the TV screen. Each character printed on the screen is at a particular 
position from the left, and a particular position from the top. 

DIM A(2,2) 

allocates space for nine variables, each called A, and each having two 
subscripts: 

A(0,0) A(1,0) A(2,0) 

A(0,1) A(1,1) A(2,1) 

A (0,2) A C1,2) A(2,2) 

Arrays may have as many dimensions as you like, may contain as many 
variables as you like, and may be either real, integer, or string. 
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One of the invaluable features of an array variable is that its subscript 
need not be specified as a number; you can use a variable: 

10 DIM A(9) 

20 X = 6 
30 A (X) = 27 

This program will place 27 in A(6). You can even use an array variable as 
the subscript: 

10 DIM A (29) 

20 X = 6 

30 A (X) = 27 

40 A(A ( X ) ) = 564.3 

Any arithmetic expression may be used as a subscript, and if the subscript 
works out to a number with a decimal point, then the number is truncated 
to its integer value, ie just the pail before the decimal point. 

Remember, when using arrays, that if you DIM using three subscripts, 
each variable must be called with three subscripts. 

10 DIM NAMES (2,2,2) 

20 NAME$(0) = "FRED" 

will not work. You would have to use, say, 

20 NAM E$(0,0,0) = "FRED" 

Be careful when using arrays - they consume vast amounts of memory, 
and if you try to use too many variables the computer will say, 

DIM Space 

meaning that there isn’t enough room in its memory. 
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RESTORE 


These instructions provide you with a way of giving data to a program 
before it is run. This means that the data can be saved as part of the 
program (see chapter 9). The variables are placed after READ, and each is 
loaded in turn from the information placed after DATA. 

10 FOR I = 1 TO 4 
20 READ Age%,Dog$ 

30 PRINT "Name: ";Dog$;" Age: ";Age% 

40 NEXT I 

50 DATA 9, BON ZO,3,R OVE R 
60 DATA 7 

70 DATA SPO T,12,HE N RY 
>RUN 

Name: BONZO Age: 9 
Name: ROVER Age: 3 
Name: SPOT Age: 7 
Name: HENRY Age: 12 

You can see that it doesn’t matter how many DATA instructions are used 
provided the types of data match the variable. 

RESTORE is used to set the data-pointer to the start of the DATA, in this 
case line 50. It can also be used to set the data-pointer to any line 
number: 

10 INPUT "Which dog Cl to 4)", A 
20 RESTORE (A+4)*10 
30 READ Age%, Dog$ 

40 PRINT "NAME: ";Dog$; n Age: ";Age% 

50 DATA 9,BONZO 
60 DATA 3, ROVER 
70 DATA 7, SPOT 
80 DATA 12, HENRY 
> RUN 

Which dog (1 to 4)?2 
NAME: ROVER Age: 3 




15 PRINT formatting 
and INPUT 


PRINT formatting 


You are already familiar with the PRINT statement, and how it is used to 
put characters on the screen. In this chapter you will find out how to use 
PRINT to position the output on the screen. 


Press 


BREAK 


and then try the following program. 


10 X = 6 
20 PRINT X;X;X 
30 PRINT X,X,X 
40 PRINT X'X'X 
>RUN 

666 

6 6 6 
6 
6 
6 


From this you can see that 

(i) Items in the PRINT instruction separated by semicolons are printed 
one after the other, with no spaces. 

(ii) Items separated by commas are tabulated into columns. These 
columns are ten characters wide and are called fields. 

(iii) Items separated by apostrophes are printed on a new line. 

Now try the following program: 

10 A$ = "J" 

20 PRINT A4;A$;A4S;A$;A$ 

30 PRINT A$,A$,A$ 

40 PRINT A$ 1 AS 1 AS 
>RUN 




60 PRINT formatting and INPUT 


JJ J 

J 

J 

J 

J 


J 


J 


This is the same program as before, but using a string variable. Notice 
that the character is not printed in the same place as the number. Here is 
another program to demonstrate this: 


10 X = 6 
20 A $ = " J " 
30 PRINT X, 
> RUN 

6 

J J 

v -S/- J ^ 

Field No 1 


XX,X'A$,A$,A$ 




6 

J 

-j 




Field No 2 Field No 3 


Each field of ten characters width is shown above. As you can see, 
numbers are printed out to the right of each field, characters to the left. 
This is done so that numbers line up in the units column, or the least 
significant decimal. 

The width of these fields can be altered, as can the number of decimal 
places to which real numbers are printed. The Electron normally gives 
each field a width of ten characters. The number of fields across the 
screen depends upon which mode you are using. There are three 
different character sizes that are available, and these give either eight 
fields, four fields, or two fields, each of width ten. 



80 character modes 40 character modes 20 character modes 

(MODES 0 and 3) (MODES 1,4,6) (MODES 2 and 5) 
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If you now type 

PRINT 6,9,7/3,57 

you will see that the 9 and the decimal equivalent of 7/3 have run into 
each other: 

6 92.33333333 57 

To prevent this happening the field width and/or the number of decimal 
places can be altered using the integer variable.® %. 

If you type 

S)% = &2040A 

and then 

PRINT 6,9,7/3,57 

you can see the effect of reducing the number of decimal places to 4. 

6.0000 9.0000 2.3333 57.0000 

The assignment of the variable @ % is made up of a number of parts: 

& indicates that a hexadecimal number follows. Hexadecimal numbers 
are explained in chapter 6. 

After the & sign, the first number of @ % indicates the format of the print 
field. 2 means that the computer will print a fixed number of decimal 
places. 

The next two figures indicate the number of decimal places which are 
required, in this case 04. 

The final two figures give the field width, in this case 0A which is 10 in 
decimal. 

So, 

a% = & 20105 

will give each number printed to one decimal place, with a field width of 
five. 
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Some more points: 

(i) The format, the first figure after the & symbol, can take three values: 

0 is the normal configuration - the format which the computer uses when 
it is first switched on. 

1 gives numbers in exponent form, that is an integer followed by a power 
of ten. So 0.0006 would be printed 6E-4. (‘Six times ten to the power of 
minus four’.) 

2, as just shown, gives numbers to a fixed number of decimal places. 

(ii) When the computer is first switched on, @ % = 0090A. This gives 
nine significant figures and a field width of ten. 

(iii) The computer will not print more than ten significant figures. The 
ten significant figure format is obtained by setting @ % to, for example, 
&00A0C. This will give ten significant figures and a field width of 12. 
Alternatively, typing @ % — 12 will give the same result, because the 
number of significant figures is assumed to be ten if it is not specified. 

You can make the print instruction convert decimal numbers or variables 
into hexadecimal by using the ~ character. 

PRINT ~10 

will give A (decimal 10 in hex). 

PRINT ~ LENGTH 

will print out the contents of the variable LENGTH in hex. 

The position on the screen at which PRINT prints is controllable by the 
TAB instruction. 

PRINT TABC16); "J" 

will print the character J 16 spaces across the screen. 

As is usual with functions, the number in the brackets may be a variable, 
or any arithmetic expression. 
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TAB can also be used with two parameters (numbers in the brackets). If 
you imagine the screen to have coordinates, the number of columns 
going across the top, and the number of rows down the side, then 

PRINT TAB(16,22); M J" 

will print the character J 16 spaces across the screen and 22 spaces 
down. 

These text coordinates vary depending upon which mode you are using. 
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TAB instructions have the effect of moving the cursor around the screen. 

PRINT TAB(0,0) 

will always move the cursor to the top left of the screen in any mode. 
If at any time you wish to turn the cursor off, you can do so by typing 

VDU 23,1,0;0;0;0; 

It will still exist of course, but it will not be printed on the screen. 

VDU 23,1,1;0;0;0; 

will return the cursor to the screen once more. 


INPUT 

So far, the only form of input that you’ve made to the computer is the 
typing of commands and programs. Often you will need to give the 
computer information while the program is running. 

10 PRINT "GIVE ME A NUMBER AND I'LL DOUBLE 
IT" 

20 INPUT X 

30 PRINT "DOUBLE ";X;" IS X*2 
> RUN 

GIVE ME A NUMBER AND I'LL DOUBLE IT 

?1 6 

DOUBLE 16 IS 32 


When you run this program, line 20 prints a question mark on the screen. 
This ques tion mark invites you to type in some data. When you press 
liiaUJilJ the number that you typed is put in X. If you don’t type a 
number, or you type letters or symbols instead, X becomes zero. 


INPUT may also be used with string and integer variables. 

10 PRINT "WHAT IS YOUR NAME" 

20 INPUT A $ 

30 PRINT "NICE TO MEET YOU, ";A$ 
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> R UN 

WHAT IS YOUR NAME 

? D OBB IN 

NICE TO MEET YOU, DOBBIN 

Lines 10 of the above two programs have been used to print a message 
on the screen. This message can be incorporated into the INPUT 
instruction. 

10 INPUT ’‘WHAT IS YOUR NAME “,A$ 

20 PRINT “ARE YOU SURE ABOUT THAT, “ AS;“?" 

> RUN 

WHAT IS YOUR NAME 7EINSTEIN 

ARE YOU SURE ABOUT THAT, EINSTEIN? 


Notice the comma in line 10 of this program. It tells the computer to print 
a question mark when it wants input from the keyboard. If you leave out 
the comma, the question mark will not be printed. A semi-colon may be 
used, and has exactly the same effect as the comma. 


When the program is running, the INPUT instruction requires you to 


press 


RETURN 


when you wish to send what you have typed to the 


RETURN 


computer. Up until 
what you have typed using 


is pressed, you can delete all or part of 


CTRL 


U or the 


DELETE 


key. 


When you are inputting a string, the computer will ignore any leading 
spaces, and anything after a comma, unless you put the whole string 
inside quotation marks. 


10 INPUT AS 
20 PRINT AS 
>RUN 

?BU S, CAR 
8US 
> RU N 

?“BUS, C AR “ 
BUS, CAR 
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Alternatively, you can use INPUT LINE, and inverted commas will not be 
needed. 

10 INPUT LINE A $ 

20 PRINT A $ 

>RUN 

? FISH, AND CHIPS 
FISH, AND CHIPS 

Several inputs can be requested at one time. 

10 INPUT A,B,C$ 

20 PRINT A,B,C$ 

> RU N 

?20.3, -16, INCHES 

20.3 -16INCHES 

This time you must use commas to separat e each piece of data which you 
type. 

Another way of entering data is to use GETS . This reads the key which you 


press. 


10 

PRINT "PRESS A 

KE Y " 

20 

A$ = GETS 


30 

PRINT "THE KEY 

YOU PRESSED WAS 


The program waits at line 20 until you press a key. As soon as you do, the 
character which that key represents is placed in AS. 

A similar instruction to GETS is INKEYS. 

10 PRINT "PRESS A KEY IN THE NEXT SECOND" 

20 A$ = INKEY $100 

30 IF A$ = "" THEN PRINT "YOU WERE TOO SLOW" 
ELSE PRINT "THE KEY YOU PRESSED WAS ";A$ 

Using this program, line 20 waits one second for you to press a key. If no 
key is pressed in that time then the program moves on. The INKEYS 
instruction has a number after it which is hundredths of a second. The 
larger the number, the longer the computer will wait for you to press a 
key. If you don’t press a key in time, IN KEYS will give the value -1. 
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Line 30 of this program shows an IF statement. IF statements are 
discussed in detail in chapter 16. 

There are two more input instructions, GET and I NKEY. These are exactly 
the same in operation as GETS and IN KEYS, but their effect is to give the 
ASCn code of the key which you press. GET and I NKEY give a number, 
and must therefore be assigned to number variables. 

10 X = GET 

20 Y = INKEY 500 

If you use either I NKEY or INKEYS with its time delay set to 0, the 
computer will not wait for you to press a key, but will merely glance at the 
keyboard to see if any key has already been pressed. This is useful when 
you come to write games, as the rest of the program is not held up waiting 
for a key to be pressed. 

It is important to know that I NKEY, IN KEYS, GET and GETS will notice not 
just the key you happen to be pressing at the time, but also any key you 
have pressed since the last time the computer asked for input. Every 
time you press a key it is placed in the keyboard buffer (a buffer is a short¬ 
term memory), and it is this buffer which GET and the others actually look 
at. 

However, if you want to ignore any keys previously pressed, and just look 
at the keyboard directly, there’s a version of I NKEY to do this. This is 
done by giving I NKEY a negative number, each key having a corre¬ 
sponding value which you can use. For example, 1NKEY( — 7U) only 
operates when the J key is pressed. This use of INKEY is discussed in 
more detail in chapter 25, including a table of all the key codes. 
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Programs and parts of programs can be made to execute over and over 
again either continuously, or a specified number of times. The in¬ 
structions you put in your program to make this happen are called LOOP 
instructions. 

The FOR . .. NEXT loop 

The most common type of loop is FOR ... NEXT, which uses a variable to 
count the number of repetitions required. 

10 FOR N = 1 TO 6 
20 PRINT N 
30 NEXT N 

> RUN 

1 

2 

3 

4 

5 

6 

In this program, N is printed at each pass through the loop. N is called the 
control variable. 

You can start the control variable at any number you choose, and you 
may alter the amount by which it changes on each pass, the step size. 

10 FOR N = 7 TO 11 STEP 1 .6 
20 FOR J = 20 TO 10 STEP -5 
30 PRINT N,J 
40 NEXT J 
50 NEXT N 

> RUN 

7 20 

7 15 

7 10 

8.6 20 

8.6 15 
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8.6 

10 

10.2 

20 

10.2 

15 

10.2 

10 


This program shows that you can use decimal step sizes, or negative step 
sizes. You may start the control variable at any value; and you may use 
FOR ... NEXT loops within each other. This is called nesting, and you can 
nest as many loops as you wish. 

Type 


LISTO 2 


followed by 


RETURN 


, and then LIST the program again. 


10 FOR N = 7 TO 11 STEP 1 .6 
20 FOR J = 20 TO 10 STEP -5 
30 PRINT N,J 

40 NEXT J 

50 NEXT N 


Each loop is shown indented from the previous one. 

L1ST0 is a list option instruction and can take any number from 0 to 7. 

LISTO0 is the normal setting - it lists exactly what the computer has 
stored in memory. 

UST01 lists the program with an extra space after each line number. 

LIST02 lists the program with indents on FOR . . . NEXT loops. 

LIST04 lists the program with indents on REPEAT . . . UNTIL loops. 

These effects may be obtained in any combination by adding the 
numbers together, so LIST03 would give extra spaces after line numbers 
and indented FOR ... NEXT loops. 

Here are some further points on the use of FOR . . . NEXT loops. 

(i) You do not need to specify the control variable to which NEXT refers. 
The following program will work exactly the same as the one above. 
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10 FOR N = 7 TO 11 STEP 1 .6 

20 FOR J = 20 TO 10 STEP -5 

30 PRINT N,J 
40 NEXT 
50 NEXT 

The computer assumes that NEXT applies to the loop it is in at the 
present moment. 

If you do put the variable names after NEXT, but get them mixed up, then 
this is what happens. 

10 FOR N = 7 TO 11 STEP 1 .6 

20 FOR J = 20 TO 10 STEP -5 

30 PRINT N,J 
40 NEXT N 
50 NEXT J 
> RUN 

7 20 

8.6 20 

10.2 20 


No FOR at Line 50 

The computer starts to execute the N loop before the J loop, and when it 
reaches line 50 it cannot find the FOR to go with NEXT J. Loops must be 
nested one within another; they must not cross. 

(ii) The number of FORs, and the number of NEXTs must be the same. 

The following program does not give an error, but it is left hanging in mid¬ 
air. 

10 FOR N = 7 TO 11 STEP 1 .6 
20 FOR J = 20 TO 10 STEP -5 
30 PRINT N,J 
40 NEXT 
>RUN 


7 

7 

7 


20 
1 5 
10 
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If you do this, you will run into trouble. 

(iii) You must never jump out of a FOR . . . NEXT loop using GOTO. As in 
(ii) above this will often not result in an error, but the program will be 
impossible to follow. 

(iv) The stop condition for a loop is that, for a positive step size, the 
control variable is greater than the terminating value; for a negative step 
size, the control variable is less than the terminating value. However, all 
loops will be executed at least once. 

10 FOR NUMBER = 6 TO 0 
20 PRINT NUMBER 
30 NEXT 

> RU N 

6 

When the loop has been completed, the control variable moves on an 
extra step, so the above program will end up with NUMBER equal to 7. 
Here is a program to show this: 

10 FOR Size = 100 TO 103 STEP 1.5 
20 PRINT "INSIDE LOOP, Size = ";Size 
30 NEXT 

40 PRINT "OUTSIDE LOOP, Size = ";Size 

> RUN 

INSIDE LOOP, Size = 100 

INSIDE LOOP, Size = 101.5 

INSIDE LOOP, Size = 103 

OUTSIDE LOOP, Size = 104.5 

(v) FOR . . . NEXT loops are used when you wish to go around a loop a 
fixed number of times. There may be as many lines as you like between 
the FOR and its corresponding NEXT, and control variables need not be 
directly assigned with numbers. They can be assigned with any arith¬ 
metic expression, containing variables or other functions. 

10 MODE 5 

20 FOR angle = 0 TO 2*PI STEP .1 

30 PLOT 69,649 + 440*SIN(ang le), 512 + 400* 

COS ( ang le) 

40 NEXT 
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The REPEAT ... UNTIL loop 

Another very useful loop is REPEAT.. . UNTIL, which waits until a condition 
is fulfilled before coming out of the loop. 

10 INPUT 1 "This program turns decimals into 
fractions"'"Give me a decimal: "decimal 
20 numeratorX = 1: denominator = 1 
30 PRINT "Program running" 

40 REPEAT 

50 fraction = numeratorX/denominatorX 
60 IF fraction>decimaL THEN denominator^ = 

denomi n a t o r X+ 1 

70 IF fraction<decima l THEN numeratorX = nu 

me rator% + 1 

80 UNTIL fraction = decimal 

90 PRINT;decimaL; M is equal to ";numerato 

r%;"/"denominatorX l "Program end" 

This program asks you to input a decimal. It then prints out the fractional 
equivalent. (Don’t input too complicated a decimal or the program will 
run for hours.) Lines 50 and 60 are repeated until the condition at line 80 
is fulfilled. In this example, the condition is that fraction = decimal. 

Line 80 is called a conditional statement, and the result of a conditional 
statement may either be TRUE or FALSE. In the example shown above, the 
statement becomes TRUE when fraction is equal to decimal, so the program 
loop is repeated only whilst the conditional statement is FALSE. Of course, 
the computer doesn’t understand TRUE and FALSE, so it assigns numeric 
values to these conditions: 

0 for FALSE, -1 for TRUE. 

There are a number of logical operators which can be used in conditional 
statements: 

A = B True when A is equal to B 

A < B True when A is less than B 

A > B True when A is greater than B 

A<= B True when A is less than or equal to B 

A>= B True when A is greater than or equal to B 

A< > B True when A is not equal to B 

NOT A True when A is false 
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TRUE True always 

FALSE False always 

A AND B True if both A and B are true 

A OR B True if either A or B is true, or if both are true 

A EOR B True if either A or B is true, but false if both are true 

There is more about logic operations in the next section on the IF statement. 

REPEAT ... UNTIL is easily followed and understood by other people who 
read your programs, and should be used in preference to GOTO. 

IF ... THEN ... ELSE 

The IF statement enables the computer to make a choice about 
something. 

10 REPEAT 
20 A$ = GET$ 

30 IF A $ = "Y" THEN PRINT "YES"; ELSE PRINT 
AS; 

40 UNTIL FALSE 

This program turns the Y key into a YES-button. Line 30 contains a 
conditional statement. If the condition is true then the computer obeys 
whatever comes after THEN. If the statement is false then the computer 
carries out whatever comes after ELSE. 

IF statements can carry out more than one instruction, if these instr¬ 
uctions are placed on the same line and are separated by colons: 

10 REPEAT 
20 A$ = GET$ 

30 IF A$ = "Y" THEN FOR I = 1 TO 6 : PRINT 
"YES";: NEXT ELSE PRINT A$; 

40 UNTIL FALSE 

and now you will get six YESs when you type Y. 

These multi-statement lines are not restricted to the IF statement. Any 
line in a program may carry out more than one instruction if each is 
separated by a colon. However, it is generally better to use a procedure 
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rather than fill an IF statement full of colons. Procedures are explained in 
chapter 17. 

IF statements may ask for a complex condition, using the logical 
operators AND, OR, and EOR. 

10 REPEAT 
20 A$ = GETS 
30 B$ = GETS 

40 IF AS = "Y" AND B$ = "Y" THEN PRINT "YES 
ELSE PRINT A$;B$ 

50 UNTIL FALSE 

This program will only print YES if you type two Ys in succession. 

The ELSE part of the statement is optional, and may be omitted. 
Alternatively you can extend the IF statement by chaining it: 

10 REPEAT 
20 AS = GETS 

30 IF AS = "Y" THEN PRINT "YES" ELSE IF AS 
= "N" THEN PRINT "NO" ELSE PRINT "MAYBE" 

40 UNTIL FALSE 

This program demonstrates the use of one IF statement after another... 

Using the IF statement you can now find out some more about how the 
computer deals with TRUE and FALSE. 

10 X = 8>6 
20 Y =6>8 
30 PRINT X,Y 
> RU N 

-1 0 

Because 8 is greater than 6, 8 > 6 is TRUE, so X is - 1. 6 > 8 is FALSE, so 
Yis 0. 


10 REPEAT 
20 INPUT X 
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30 IF X THEN PRINT;X; ” IS TRUE" ELSE PRINT 
;X; " IS FALSE" 

40 UNTIL 0 

This program allows you to enter numbers, and to see whether the 
computer treats them as TRUE or FALSE. You will see that only 0 is 
treated as FALSE, all other values being TRUE. 

The above program can be rewritten; 

10 REPEAT 
20 INPUT X 

30 IF X THEN PRINT ;X;" IS TRUE" ELSE PRINT 
;X;" IS FALSE" 

40 UNTIL FALSE 

which has exactly the same effect. 

Another important use of IF is with strings and string variables. For 
example, you might find this in the middle of a program 

100 REM The answer should be 560 
110 INPUT "SO WHAT * S THE ANSWER THEN?"'X 
120 IF X = 560 THEN A$ = "YES" ELSE AS = "N 
0 " 

130 IF A $ = "YES" THEN PRINT A$;" WELL DONE 
" ELSE PRINT AS;" TRY AGAIN" 

This will test to see what string A$ contains, and will print one of two 
messages accordingly. 

Less than and greater than can also be used; 

10 A$ = "HELLO" 

20 IF A$ < "GOODBYE" THEN... 

This will be true, because the IF statement compares the ASCII values of 
the first character in each string. If the first two characters are the same, 
then the next two characters are compared, and so on. So ‘MELON’ is 
less than ‘MELTED’. This is very useful for putting strings into 
alphabetical order, but it does not work if the strings are a mixture of 
upper and lower case letters. 
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The following operators may be used with strings: 


— 

the same as 

<> 

not equal to 

< 

less than 

> 

greater than 

<= 

less than, or equal to 

>= 

greater than, or equal to 
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Using procedures allows you to split up virtually any program you are going 
to write into a main program, followed by a number of ‘mini-programs’ 
(procedures), which can be called from the main program by a single 
statement. 

A procedure is simply a collection of numbered BASIC statements which 
you write in order to perform a particular task. This collection of 
statements looks just like part of an ordinary program, but the 
differences are that the first line contains the name of the procedure 
(which is decided by you), and the last line contains a BASIC word to 
signify the end of the procedure. When the computer encounters the end, it 
then returns to the main program and carries on. 

The rules for using procedures are very simple. A procedure is called 
from the main program by the BASIC word PROC followed immediately 
by the procedure’s name. The name can be anything you like, but there 
must be no spaces in it. For example: 

PROC new Line 

PROC wait_a_second 

PROCDRAWPICTURE 

Note the underline character in the second example which helps ‘space 
out’ the name. 

A procedure name should reflect the function of the procedure to which 
it applies. If you merely name your procedures PROCA, PROCB, PROCC, 
for example, then no one will understand what they do without having to 
work through each one. So if you have a procedure which converts feet 

into metres, then call it PROCfeet_to_metres. It is best to use lower 

case names for procedures so that they distinguish themselves from the 

PROC. 

To define a procedure, you simply type a line number, followed by OFF, 
followed by the procedure name. It is a good idea to start defining your 
procedures at a fairly high line number, say 1000. 
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1000 DEF PROC wait a_second 
1100 NOW = TIME 

1200 REPEAT UNTIL TIME-NOW>=100 
1300 ENDPROC 


This procedure will do as its name suggests. 

ALL PROCEDURE DEFINITIONS MUST END WITH ENDPROC. 

When you want the computer to carry out the instructions in the 
procedure, you have to call it by name: 

70 PROCwait_a_second 

or 

120 IF INKEY $10 = n W" THEN PROCwait_a secon 
d 

You may have as many procedures in your program as you like, and 
usually the more the better. 

THERE MUST ALWAYS BE AN END INSTRUCTION BETWEEN 
THE END OF THE MAIN PROGRAM AND THE PROCEDURE 
DEFINITION. 

For example 

10 REM Sample program 
20 FOR X = 0 TO 29 

30 PRINT TAB(10,10);"COUNTING..."X" Seconds 

11 

40 PROCwait a second 
50 NEXT 

60 PRINT TAB(10,10);"Half a minute up! 

m 

70 END 

1000 DEF PROCwait_a second 
1100 NOW = TIME 

1200 REPEAT UNTIL TIME-NOW>=100 
1300 ENDPROC 


There is a program on the Introductory Cassette to illustrate the use of 
procedures, and also give you some fun. Load this program which is 
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called ‘BUGZAP’ into your Electron first. See chapter 4 for instructions 
on how to load a program. 


When you LI ST a long program obviously you cannot see all of the lines on 
the screen at the same time. Using LIST with specified line numbers is 


nnp wav around this, but another is to put the computer into paged mode. 


This is done by pressing 


CTRL 


N. (No 


RETURN 


is required.) If you now 


A. iliU XV J L -q 

use LIST, the program will be listed until the screen is full. When you want 


SHIFT 


to look at the next part just press_ 

appear. If you want to change a line number, yo u mus t press 
To get the computer out of paged mode, type QQ] O. 


and another screen full will 


ESCAPE 


Look at just one procedure from this program: 


520 DE F PROCinfo 
530CLS 

540PRINT 111 *'"WeLcome to the game of Bugzap 

i >» * i * 

550PRINT"The object of the game is to use y 
our" 

560PRINT"Laser gun to zap the descending bu 

g" 

570PRINT M before it Lands or bombs you." 
580PRINT 1 "Your score increases every time y 
ou" 

590PRINT"zap the bug, with more points bein 

g" 

600 PR I NT"given the Lower the bug is; it wiL 
l be" 

610PRINT"dispLayed when you are kiLLed." 
620PRINT*"The controls are:"* 

630PRINT"Z = Left" 

640PRINT"X = right" 

650PRI NT"SP AC E = fire" 

660PRINT' 1 "Pressing the ESCAPE key wiLL tak 
e you” 

670PRI NT"to the end of the program." 
680PRINTTAB(5,31)"Press SPACE to start the 
game"; 

690 REPEAT: UNTIL GET $ = " 

700ENDPROC 


IV 
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This procedure is called from line 90 of the main program. 

90PROC info 

Line 520 is the start of the definition. 

Line 530 clears the screen. 

Lines 540 to 680 print the introduction and instructions about the 
BLTGZAP game which you see when you run the program. 

Line 690 is an example of putting two separate BASIC statements after 
one line number by separating them with a colon. The purpose of line 690 
is to wait until the space bar is pressed: GET$ — When the space bar is 
pressed, line 700 is executed. 

Line 700 signifies the end of the procedure, and the computer goes back 
to the main program to the line immediately after the procedure call 
(9fJPROCinfo), which is line 100. 

Here is one of the procedures from the ‘MARSLANDER’ program - also 
on the Introductory Cassette. 

860DEF PR0Crocket(direction%) 

870 R EM If there is any fuel then fire roc ke 
t-motor and make sound 

880 IF f ue L % THEN fuel%=fuel%-1 ELSE ENDPROC 
890 IF f ue L %= 29 THEN SOUND 1,-10,60,10 ELSE 
SOUND 0,-1,5,2 

900ON direction% GOTO 910,920,930,940 
910VY%=VY%- 5:ENDPROC 
920VX%=VX%+10:ENDPROC 
930VY%=VY%+15:ENDPROC 
940VX%=VX%-10:ENDPROC 

This procedure alters the speed of the spacecraft according to the 
direction in which it is pointing, which is given by the variable direction%. 

This procedure is called from line 250. 

2 50 IF INKEY(-99) THEN PROCrocketCZ%) 

Z% is an integer variable which is used by the program to give the 
attitude of the spaceship. 
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When the computer reaches line 250 it tests to see if the space bar is 
pressed. If it is, the computer then places the contents of Z% into 
direction %. 

The variable Z%, and hence the parameter direction%, can be anything 
from 1 to 4, where 1 indicates the capsule pointing up, 2 to the right, 3 
down, and 4 to the left. These positions are represented by characters 
224 to 227 which are user-definable. 

Line 880 checks to see whether there is any fuel left. The variable fuel% 
will be FALSE when it is zero and the procedure will end. 

If it is TRUE one unit of fuel is deducted by decrementing its contents by 
1. Line 890 makes either a ‘beep’ (fuel is low), or a rocket motor sound 
(fuel is not low). 

SOUND is explained in chapter 22. 

Line 900 uses ON . . . GOTO, to act according to the direction of the 
spacecraft. The parameter direction% now contains the value given to it 
by Z%. If the spacecraft is pointing up, direction% is 1 and execution 

continues at line 910. 

Line 910 decreases the vertical speed of the capsule. (VY% is the vertical 
speed measured positive in a downward direction; VX% is the horizontal 
speed measured positive in a left-to-right direction.) If the capsule is 
pointing to the left line 900 passes execution to line 920 which increases 
the horizontal speed of the capsule. 

Lines 930 and 940 increase the vertical speed and decrease the 
horizontal speed respectively. After any one of these lines (910 to 940) 
has been executed, the procedure ends. 

Using parameters in procedures 

Using the above example, Z% and direction% are termed parameters. 
The idea behind using parameters is that they are more efficient than 
global variables. A global variable is one which is accessible throughout 
the whole program, and may be altered or re-assigned at any line number. 

Once a global variable such as Z% has been passed to the procedure as a 
parameter, the variable which takes its place, direction%, is only known 
to that procedure. Outside PROCspaceship you can ask the computer to 


252 PRINT direction% 
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and it will give an error because the variable direction% does not exist in 
that part of the program. Global variables which are passed to the 
procedure are called the actual parameters, and the variables within the 
procedure are called formal parameters. 

A procedure may be defined with only one parameter, or it may be 
defined with lots of parameters. But a procedure must always be called 
with the correct number of parameters. PROCspaceship, starting at line 
750, has three parameters. 

So you could not call PROCspaceship(X%,Y). 

Parameters may be integer, real, or string. If a string variable is used as a 
formal parameter then it must have either a string or a string variable 
passed to it. Real and integer parameters may be passed to one another 
and interchanged freely, but remember that the fraction part of a real 
variable will be lost when assigned to an integer variable. 

The idea of a variable being defined only within a certain section of a 
program is commonplace in a lot of computer languages, but unusual in 
BASIC. Electron BASIC allows you to declare any variable as local to a 
procedure or function (functions are discussed in chapter 19). A local 
variable may even have the same name as a global variable in the same 
program, but will lead a separate existence. 

For example: 

10 FOR I = 1 TO 3 
20 PROClocal (I) 

30 PRINT "OUT OF PROCEDURE I = I 
40 NEXT I 
50 END 

60 DEF PROC local (J) 

70 LOCAL I 
80 I = J 
90 I = 1*10 

100 PRINT “IN PROCEDURE I = M ;I 
110 ENDPROC 
> RU N 

IN PROCEDURE I = 10 
OUT OF PROCEDURE I = 1 
IN PROCEDURE I = 20 
OUT OF PROCEDURE I = 


2 
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IN PROCEDURE I = 30 
OUT OF PROCEDURE 1=3 

Notice line 50 which says END. Because procedures are usually defined 
at the end of a program, you sometimes need to stop the execution after 
all the calls have been made. The program will terminate when the 
computer reaches the instruction END. 

There is still another way to use procedures, and that is recursively. A 
recursive procedure is one which calls itself from within its own 
definition. 

10 answer = 1 

20 INPUT X 

30 PROCfactorial(X) 

40 PRINT answer 
50 END 

60 DEF PROCfactori al (N) 

70 answer = answer*N 

80 IF N > 1 THEN PROCfactori a l (N-1 ) 

90 ENDPROC 

This is a recursive procedure to find the factorial of a number. Check 
through the logic of it in your head to see that it works. Recursive 
procedures are very useful in certain circumstances, but they consume 
memory very quickly. 
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There are four more instructions in Electron BASIC which can be used 
to tell the computer to continue executing the program at specified 
points. 

These are: 

GOTO 

GOSUB . . . RETURN 
ON . . . GOTO 
ON . . . GOSUB 


GOTO 

The simplest of these instructions is GOTO. 

10 PRINT M SCREENFUL M 
20 GOTO 10 


Each time the computer executes line 20 it is sent back to line 10 once 
again. This program never ends: it is a continuous loop. To stop the 


program you may press either 


ESCAPE 


or 


BREAK 


If you press 


ESCAPE 


ceased. 


a message is printed giving the line number at which execution 


GOTO instructions may send control of the program either forwards or 
backwards, but you must be careful not to use too many GOTO loops - 
they soon become impossible to follow, and very difficult to correct when 
a program does not function as you wish it to. It is far better to use 
procedures or REPEAT . . . UNTIL statements where possible. 


GOSUB...RETURN 

GOSUB stands for ‘Go To Subroutine’, and is really just a variation of 
GOTO. It is strongly advised that you use the more readable and more 
flexible procedure instead of GOSUB. It is used when a particular routine 
is used several times in different parts of the same program, for example 
to read a key. 
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It is most useful with IF statements. 

Here is a game which requires you to put a set of numbers in sequence. 
The GOSUB routine is called from various parts of the program, and has 
the effect of swapping the numbers around according to which key you 
press. 

10 REM SWAP-ROUND 
20 MODE 6 

30 VDU 23,1,0;0;0;0; 

40 answer$="123456789" 

50 number$=answer$ 

60 INPUT TAB(8,16)"Difficu Lty level",level 
70 FOR 1=1 TO level 
80 position=RND(8)+1 
90 GOSUB 210 
100 NEXT 

110 CLS:PRINT TAB(15,10);number$ 

120 PRINT TABC6,16)"Press a key between 2 
and 9" 

130 REPEAT 

140 position=VAL GET$ 

150 IF position <2 OR position>9 THEN GOTO 
140 

160 GOSUB 210 

170 PRINT TAB(15,10)number* 

180 UNTIL number$=answer$ 

190 PRINT TAB(6,16);SPC(9);"Well done";SPC( 
11); "END" 

200 END 

210 temporary$= M " 

220 FOR J =position TO 1 STEP-1 

230 temporary$=temporary$+MID$(number$,J,1) 

240 NEXT 

250 number$ = temporary$+MID$ (number$,positio 
n + 1) 

260 RETURN 


As you can see, GOSUB differs from GOTO in that the program flow must 
always RETURN to the position following the subroutine call. 

Just one point about GOSUB. 
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As with FOR ... NEXT, you should not jump out of a subroutine by using 
GOTO. If the computer keeps being told to GOSUB, without ever 
encountering a RETURN, it will soon use up its memory. 

ON . . . GOTO, ON . . . GOSUB 

An instruction such as 

ON N GOTO 100,200,70,260 

means that the computer checks on the value of N, and then ‘jumps’ to 
the Nth line number in the list. 

So, ifN= l,the program‘jumps’ to line 100; if N = 2 to line 200;ifN = 3 
to line 70; and if N = 4 to line 260. 

ON . . . GOSUB works in exactly the same way. 
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Functions are similar to procedures, but they have only one purpose - to 
give a single result. The easiest way to understand a function is to 
describe some of the computer’s own. It has lots - the trigonometric 
functions such as SIN, TAN and COS. One of the most useful functions is 
RND, which supplies random numbers. It is usually used with a 
parameter, and gives a random integer between 1 and the value of the 
parameter. So, RND(50) will pick a random number between and 
possibly including, 1 and 50. When you type X — RND(4), you know that 
the result of the function RND will be placed in X. The RND function is 
described in more detail in chapter 25. 

A function can be used with any number of parameters, both string and 
numeric. Here is a function to determine the mass of a sphere: 

100 DEF FNmass_of_sphere(radius,densi ty ) 

110 = 4/3*PI*radius a 3*density 

Here’s another example of using a function in a program 
5 CLS 

10 REM Discount calculator 

20 PRINT ,,,,,,M This program calculates the 
following discounts:" 

30 PRINT **" 2 ^% on £100 or less" 

40 PRINT ' 1 "30% on £101 to ‘200" 

50 PRINT ' 1 "50% on anything over £200" 

60 INPUT 1 ,l ' "Enter the sum £" Y 
70 PRINT ,,,,M Final sum with discount is 
£";FN discount (Y) 

80 END 

100 DEF FN_discount(SUM) 

110 IF SUM~<= 100 THEN =SUM - (20*SUM/100) 
120 IF SUM > 100 AND SUM <= 200 THEN =SUM - 
(30*SUM/100) 

130 IF SUM > 200 THEN =SUM - (50*SUM/100) 


The main program starts at line 5 and ends at line 80. 
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Line 5 clears the screen, and lines 20 to 50 print instructions on the 
screen. 

Line 60 prints a request for you to enter an amount, waits for you to do so, 
and puts the value into variable Y. 

Line 70 prints a message, and calls a function called FN_discount(Y). 

The value in Y is passed to the function’s parameter, (which is the ‘actual’ 
parameter). 

Line 100 starts the definition of the function, and passes the parameter 
value to a ‘formal’ parameter called SUM. 

Line 110 contains a conditional statement. If the value of SUM is 100 or 
less, then the function returns the result given by SUM — (20*SUM/100). 
If the value of SUM is more than 100, then the execution of line 110 stops 
before working out the SUM — (20*SUM/1W) , and line 120 has a go-and 
so on. 

Notice the underline character in Fl\|_discount. This helps to make the 

function’s name more readable. 
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Introduction 

This chapter deals with the VDU software - anything to do with how 
things are put on to the screen (ie the television or monitor). What 
‘modes’ are and why they are there is covered first, followed by a section 
on writing text and then details on the graphics routines. Lastly the 
palette is covered. All the individual VDU commands are listed for 
reference in the next chapter. 

Modes - what are they and why? 

The screen displays things in any one of seven modes, labelled from 
MODE 0 up to MODE 6. To change mode is easy - just type MODE 
followed by the mode number you want. For example 

MODE 2 liHHlihl 

changes the display to mode 2. As with all VDU commands, it can be used 
as a line in a program, and as it is a good idea to make sure your program 
starts off in the right mode, have its first line looking something like this: 

10 MODE 1 

Changing mode changes four things: 

- The number of characters you can get on the screen. 

- The number of pixels (dots) the graphics can display (and hence the 
resolution of the graphics). 

- The number of colours available at any one time on the screen. 

- The amount of memory left for programs. 
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A table giving details of these is listed below. 



No of 

No of 

No of 

Memory 

Mode 

characters 

graphics pixels 

colours 

used 

0 

80 X 32 

640 X 256 

2 

20K 

1 

40 X 32 

320 X 256 

4 

20K 

2 

20 X 32 

160 X 256 

16 

20K 

3 

80 X 25 

(text only) 

2 

16K 

4 

40 X 32 

320 X 256 

2 

10K 

5 

20 X 32 

160 X 256 

4 

10K 

6 

40 X 25 

(text only) 

2 

8K 


If you don’t understand the ‘memory used’ column then don’t worry - 
basically the more detail and colours available in the mode, the more 
memory the screen uses and the less there is available for programs. The 
word ‘colour’ is used rather loosely to include the flashing colour effects. 

Try the different modes out to see the differences. Modes 3 and 6 are for 
text only - no graphics can be done in these modes (nothing will actually 
go wrong - it just won’t appear). 

Why have modes? Different programs have different requirements - 
some just need simple text output and mode 6 then leaves free as much 
memory as possible for the program. Others, such as games, need lots of 
colours and graphics detail. The modes available give a good range 
across this spectrum. 


Writing text 

The COLOUR command and text windows 

When a letter is written to the screen it has foreground and background 
colours - the colours of the ink and the paper. When the machine is 
turned on, it is always white foreground on black background. Colours (or 
more strictly logical colours — see the section on the palette) are labelled 
from 0 upwards. To take a definite mode for simplicity, mode 1 has four 
colours labelled from 0 to 3. Try the following: 


RETURN 


This puts you in mode 1 with white text on black background. 
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COLOUR 1 l;hiU:li 

This sets the foreground colour to number 1 (red). Text after this 
command is red on black. 

colour 130 LliilLU 

This sets the background colour to number 2 (yellow). Text after this is 
now red on yellow, and clearing the screen with CLS makes the entire 
screen yellow. Why 130? Because to change the background instead of 
the foreground colour you must add T28 to the colour number. Thus, to 
get background colour 2 (above), add 128 to give 130. 

Changing mode resets the colours to white on black. As said before, any 
VDU commands (including COLOUR, GCOL, MOVE, DRAW etc) can be 
either typed straight (as a ‘direct command’) or used as part of a BASIC 
program. 

Addresses on the text screen 

Each letter position has its own address in the usual columns and rows 
format. The column numbering is from left to right starting from column 
0 and the rows, as for all VDUs, are labelled from the top (row 0) 
downwards. How many rows and columns there are depends on the mode 
- the drawing below shows the labelling for mode 6. 

The text screen for mode 6 
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The cursor may be positioned to any part of the screen with the TAB(X,Y) 
command, thus the following program prints out a diagonal line of As. 

10 MODE 1 

20 FOR IX=0 TO 20 

30 REM The next line positions the text cur 
sor to the position col.=I%+5 row=I% 

40 REM and prints the letter A at this pos 
i t i on 

50 PRINT TAB(I%+5,I%);"A" 

60 NEXT 1% 

70 END 

Text windows 

Normally, the text may appear anywhere on the screen. However a text 
window may be set, which allows the text to appear only inside the 
window. To do this, the VDU 28 command is used as follows: 

VDU 28,a,b,c,d 

where a,b is the bottom left and c,d the top right position inside the 
window (see the drawing below). 
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Nothing outside the text window is affected by text commands, such as 
screen clearing, scrolling, cursor positioning etc. Note that the TAB{X,Y) 
measures from the position of the top left of the current window. Try the 
following program 
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10 MODE 1 

20 REM Set up a text window only 6 characte 
rs square 

30 VDU 28,5,10,10/5 

40 REM Change the background colour to colo 
ur 1 (red) 

50 COLOUR 129 

60 REM Now clear the text screen to red to 
see where it is 
70 CLS 

80 REM Demonstrate scrolling 

90 FOR I%=1 TO 20 : PRINT 1% : NEXT IX 

100 REM lastly, show position of character 

(2,2) relative to text window 

110 PRINT TAB (2,2); M *" 

120 END 

Both text and graphics windows are removed by VDU 26. 

Defining your own characters 

Each character is an 8 by 8 matrix of dots (pixels). All the normal letters, 
numbers and punctuation marks are defined, but it is possible to define 
your own. 256 bytes of RAM are set aside for the definitions of 
characters whose codes are from 224 to 255. Character definitions are 
entered thus: 

VDU 23 ,CODE,L 1 ,L2,L3,L4,L5,L6,L7,L8 

where CODE is the code of the character to be defined (it is then printed 
using either VDU CODE or PRINT CHR$(C0DE);) and 

Ll is the bit pattern of the top row 

L2 is the bit pattern of the second row from top, and so on until . . . 
L8 is the bit pattern of the bottom row. 

What is a bit pattern? Each dot in any one row is given a number, and the 
bit pattern is the sum of the numbers corresponding to those bits in 
foreground. These numbers, labelling the bits from left to right, are 128 
(for the leftmost pixel), 64, 32, 16, 8, 4, 2, 1 (for the rightmost pixel). 
Specific examples are easiest to understand. 
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The space character obviously has no foreground, thus all the bit 
patterns are zero, so to assign the space character to the code of 224, the 
command 


VDU 23,224,0,0,0,0,0,0,0,0 

would be used. To define a large X, the top line has the left and rightmost 
pixels set only, thus L 1=128+1 = 129. The next line has the second from 
left and the second from right pixels set, thus L2=64+2=66. Similarly, 
L3=32+4=36 and L4= 16+8=24. The fifth through to eighth rows are 
the mirror image of the first four, so to define the character 225 as an 
X, type the following line: 


VDU 23,225,129,66,36,24,24,36,66,129 


RETURN 


To display the character, type VDU 225 


RETURN 


All the characters from 32 to 255 may be defined, but to define those 
outside the codes 224-255 it is necessary to allocate more memory for 
the fount. This is called ‘exploding the fount’ and is done via FX call 
number 20. 


Here is another example of defining a character. The alien in the 
BUGZAP program on the Introductory Cassette was made up on the 
matrix in the drawing below. 


OO 

<M -#i CM to 



16 + 8 = 24 
32 + 16 + 8 + 4 = 60 

64 + 32 + 16 + 8 + 4 + 2 = 126 

128 + 64 + 16 + 8 + 2 + 1 = 219 

64 + 32 + 16 + 8 4- 4 + 2 = 126 

32 + 4 = 36 
64 + 2 = 66 
128 + 1 = 129 


If you use the code 224 for the new character definition, here is the VDU 
statement which defines the complete character: 


VDU 23,224,24,60,126,219,126,36,66,129 


RETURN 


By changing L7 and L8, the ‘upright’ alien shown in the drawing below 
can be defined. The code for this character must be a different one from 
the one above (eg 225), otherwise you will lose the original alien. 




Graphics 95 



Have a go at defining this new character, then check the result by 
displaying it on the screen with 


RETURN 


The program below shows how you can produce an animated alien by 
using both these characters. 

10 VDU 23,224,24,60,126,219,126,36,66,129 
20 VDU 23,225,24,60,126,219,126,36,36,36 
30 MODE 2 

40 VDU 23,1,0;0;0;0 
50 REPEAT 

60 PRINT TAB(10,16);CHR$(224) 

70 NO W% = TIME : REPEAT UNTIL TIME = N0W%+25 
80 PRINT TAB(10,16); CHR$<225) 

90 N0W% = TIME : REPEAT UNTIL TIME = N0W%+25 

120 UNTIL FALSE 


Line 40 gets rid of the flashing cursor, which would otherwise be a 
distraction. You can retrieve it by typing 


VDU 


23,1,1;0;0;0;0 


RETURN 


Graphics 

Introduction 

The graphics instructions are pretty extensive in the Electron, and they 
all have certain things in common. The easiest commands to understand 
are the MOVE and DRAW commands, and these will be used for 
illustration in the following section. The ideas presented here are true for 
all graphics commands (including SU3). 
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REMEMBER: when you press 


BREAK 


, the computer is in mode 6. This 


is not a graphics mode and nothing will happen when you try to plot 


things. Always remember to go into a graphics mode to try these things 
out. Mode 1 is a good one to start with. Similarly, programs should always 
have a MODE command in them, as described at the beginning of this 
chapter. 


The graphics coordinate system 

Firstly, we must describe the coordinate system, that is to say how 
positions of points are labelled. This is similar to the text coordinate 
system but there are three differences. 

Firstly the system has the point (0,0) in the bottom left hand corner, and 
row numbers are labelled upwards. 

Secondly, the top right hand point on the screen is (1279,10 23) , the same 
in all modes (see the drawing below). This is so that drawing a line from, 
say (100.100) to (400.400) always draws a line in the same place, even 
though the pixel size varies with the mode. 

Lastly, points off the screen are well defined, that is to say, drawing a line 
from, say (—300,—400) to (300,400) is perfectly legal, and what appears is 
what you would expect - that portion of the line that is in the area viewed 
by the screen. 


The graphics screen 

1023 - 

Y 

0 - 

0--► X 1279 


The graphics cursor is an invisible point on the screen, and is where you 
are about to draw from. Move it about the screen with the MOVE 
command, and drawing is easiest with the DRAW command. Thus 




Graphics 97 


MOVE 100,100 
DRAW 400,400 



moves the cursor to (100.100) and draws a white line to (400,400). Try 
lots of lines in different modes to get the feel of the coordinate system. 


The GCOL command 

Just as the foreground and background colours of text were defined 
using the COLOUR command, so the corresponding colours in graphics 
are defined using the GCOL command. Try the following: 


RETURN 


MODE 1 

GCOL 0, _ 

draw 300,300 rmirni 


RETURN 


This draws a line in colour 1 (red) from (0,0) - where the graphics cursor 
is when the mode is changed-to (300,300). However, you will notice that 
the GCOL command has two numbers after it. The second is just like the 
COLOUR command’s number, that is the foreground colour number, or, if 
128 is added to it, the background colour number. CLG is the graphics 
equivalent of CLS and clears the graphics area to the current graphics 
background colour. Thus 

GCO L 0,129 
CLG 



sets the graphics background colour to 1 and clears the graphics screen 
to this colour (red). Note that the CLG command is much slower than the 
CLS command. 

The first number in the GCOL command is unusual. It tells the computer 
what to do with the graphics point. The following values are defined: 

0 - write the point to the screen (what one would normally expect). 

1 - OR the point to be plotted with what is on the screen. 

2 - AND the point to be plotted with what is on the screen. 

3 - EOR the point to be plotted with what is on the screen. 

4 - INVERT what is on the screen, regardless of what colour is to be 

plotted. 

5 - leave what is on the screen alone. 
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Other values do stripey things which may change with different releases 
of the software. 

What is meant by OR, AND, EOR and INVERT? Each pixel has a colour 
- in mode 1 with four colours, this is from 0 to 3, or 00, 01, 10 and 11 in 
binary. What appears on the screen is the result of a logical operation 
between the pixel you want to plot and what is already on the screen. The 
OR and the AND are the same as for the BASIC commands. EOR means 
‘exclusive OR’, which is the same as OR unless both bits are one, in which 
case the result is zero. Again, all this is most easily explained by specific 
examples. The following assumes that you are in mode 1. 

Assume there is a red screen (from GCOL0,129 :CLG, above). Setting 
GCOL 1,2 sets the foreground colour to 2 (10 in binary), and the colour 
‘mode’ to OR. Drawing a line then takes the red pixel on the screen (red- 
colour 1 = 01 in binary), and ORs it with the yellow pixels you are 
plotting. The pixel colour that appears is the 01 ORed with 10, which is 
11, colour 3, which is white. (Try it). 

Given this white line on a red background, set the colour with GCOL 2,2, 
which has foreground colour 2 and colour mode AND. Plotting a line then 
takes what is on the screen and ANDs it with the yellow pixel, colour 2 or 
10 in binary. Therefore when the line is plotting on the red background, 
01 (red) is ANDed with 10 (yellow), then result being 00 (black). If it 
crosses the white line - the white pixels (11) are ANDed with the yellow 
pixels (10) to give 10 (yellow). 

Setting GCOL 3,131 sets the background colour to 3 (white) and the 
colour mode to EOR. Doing a CLG then EORs its pixel with 11 - that is to 
say 00 goes to 11, 01 to 10, 10 to 01 and 11 to 00. The screen is thus 
inverted in colour, and repeating the command restores it to its original 
state. 

If this does not seem too clear, playing around with it for a little should 
help. It has two main purposes - setting the EOR mode allows erasure of 
a line by plotting it again. In four colour modes, two independent two- 
colour pictures may be drawn and selectively displayed using the palette. 
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The PLOT command 

MOVE and DRAW are two special cases of the more general PLOT 
command, which is as follows. 

PLOT KX,X%,Y% 

where K% is the plot mode (ie what you are actually going to do); X% and 
Y% are the coordinates of the point to which you are plotting. 

K°/« takes the following values: 

0 Draw a line, relative (that is X% and Y% are displacements 

from the current graphics cursor position), with no change 
on the screen. 

1 As 0, but draw in foreground colour. 

2 As 0, but invert what is on the screen (colour mode 4 
forced). 

3 As 0, but draw in background colour. 

4 to 7 As 0 to 3 but plot absolute (plot to the point X%,Y%). 

8 to 15 As 0 to 7, but plot the last point twice. This is so that when 

plotting in inverted modes, the line is continuous. 

16 to 31 As 0 to 15 but with a dotted line. 

32 to 63 Reserved for the graphics extension ROM. 

64 to 71 As 0 to 7, but plot the specified point only. 

72 to 79 Fill sideways on background colour (see below). 

80 to 87 Plot triangles (see below). 

88 to 95 Fill right on non-background colour (see below). 

96 to 255 Reserved for graphics extension ROM. 


Advanced graphics 

Triangle plotting 

This plots a solid triangle using as vertices the point specified, the 
graphics cursor and the previous graphics cursor. This can be used to fill 
many different shapes. 

Sideways filling on background colour 

This plots the line sideways from the specified point, left and right, until 
either the edge of the window is reached or the line meets a pixel of non- 
background colour. The graphics cursor is set to one of the end points, 
and the previous graphics cursor (used in triangle plotting) to the other. 
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The values of these may be found out via FX call number 13 (decimal). If 
the point specified is outside the graphics window, or is not on 
background colour, then the Y coordinates of the returned points are 
different. 

Filling right 

Filling right until background colour plots right from the specified point 
as far as either the edge of the graphics window or a pixel of background 
colour is found. The endpoints (note that it does not go left) are 
retrievable via FX 13 in the same way. The endpoint is actually the first 
pixel of background colour found, thus if the specified point is back¬ 
ground colour, the endpoint returned is the same as the specified one. 

These two routines together enable a fast routine to be constructed to fill 
any enclosed shape. 

The VDU command 

The VDU command writes a series of bytes to the screen in a similar way 
to the PRINT command. Thus the following two commands are exactly 
the same: 

VDU 12,65,66,67 


PRINT CHR$(12); CHR$(65); CHR$(66); CHR$(67 

>; 

(Note the semicolon at the end of the PRINT statement - the VDU 
command does not send a carriage return unless you explicitly tell it to). 
Most numbers that you need to write to the VDU are single bytes 
(characters, for example). However, the graphics coordinates are all 
double byte quantities and are sent lower byte first, higher byte second. 
The VDU command enables this to be done easily. If a number in the VDU 
command is followed by a semicolon, that number is interpreted as a 
double byte quantity. If you are unsure of bytes and double bytes, the 
quick rule is that if you are doing a graphics operation using the VDU 
command, you must always follow a graphics coordinate with a semi¬ 
colon. This only applies to the VDU command. 

There are two more graphics commands, both of which are done via the 
VDU command. 
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Graphics windows 

Just as text may have a text window defined, outside of which no text 
command has effect, so a graphics window may be similarly defined. This 
is done with 

VDU 24,L%;BX;RX;T%; 

where L%,B% and R%,T% are the coordinates of the lower left and upper 
right pixels inside the window. Setting a window thus prevents any 
plotting outside it. Also, because CL6 is just another plot command, 
defining a graphics window and doing a CLG is a quick way of plotting 
rectangles. 


1023 
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Gra] 

win 

}hics 

dow 
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The graphics origin 

So far it has been said that the point (M) is at the bottom left hand 
corner of the screen. This point (called the origin) may be specified to live 
elsewhere with the origin command. 

VDU 29, XX; YX; 

sets the position of the origin on the screen for future graphics 
commands. Thus to set the origin in the middle of the screen, use VDU 
29,640:512;. It does not move the physical position of what is on the 
screen, the graphics windows or the graphics cursor. 
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Plotting characters 

If VDU 5 is entered, the text and graphics cursors are said to be joined, 
that is text appears at the graphics cursor which then moves as the text is 
written. This is mainly used for labelling graphs. The graphics cursor 
points to the top right pixel of the 8 by 8 character cell to be written, and 
is moved 8 pixels along by writing letters. This is seen in the following 
program. 

10 M0DE1 
20 VDU 5 

30 REM ALL the text now appearing is 'plott 
ed • 

40 DRAW 500,500 
50 PRINT "HeLLo mummy"; 

60 REM the Last print statement moved the g 
raphics cursor 

70 REM as can be seen by the next pLot st 
atement • 

80 DRAW 0,0 
90 END 

VDU4 restores the text cursor. 

The palette 

Colours defined through the COLOUR and GCOL commands are more 
properly referred to as logical colours. When a mode is changed, these 
logical colours appear as certain physical colours, thus in mode 1, colour 
1 is red and colour 2 is yellow. The palette allows this to be changed, thus 
colour 1 may be made to be blue and colour 2 flashing black on white. To 
be exact, we must distinguish between two types of colour: 

The logical colour is what is output by the COLOUR commands. The 
maximum logical colour is limited by the number of colours available in 
the mode. 

The physical colour is what appears on the screen. The physical colours 
and their numbers are listed below. 
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Physical number Display colour 
0 Black 

1 Red 

2 Green 

3 Yellow 

4 Blue 

5 Magenta 

6 Cyan 

7 White 

8 Flashing black/white 

9 Flashing red/cyan 

10 Flashing green/magenta 

11 Flashing yellow/blue 

12 Flashing blue/yellow 

13 Flashing magenta/green 

14 Flashing cyan/red 

15 Flashing white/black 

Each logical colour has a physical colour assigned to it, which may be 
changed by reprogramming the palette. This is done as follows: 

VDU 19,L% / P% / 0,0,0 

where L% is the logical colour and P% is the physical colour. So in mode 1, 
to change all the pixels with logical colour 3 (usually white) to blue 
(logical colour 4), the command VDU 19,3,4,11,0,0 is used. Thus while the 
very detailed mode 0 is a two colour mode, the colours themselves may 
be anything available from the palette, such as green on red. Note also 
that the palette reprogramming is very fast as it does not involve a lot of 
the screen memory being reprogrammed. 



21 VDU codes 


Introduction 

The statement VDU X is equivalent to PRINT CHR$(X); and the statement 

VDU X,Y,Z is equivalent to PRINT CHR$(X);CHR$(Y);CHR$(Z); 

However the VDU statement finds most common use when generating 
ASCH control codes and a detailed description of the effect of each 
control code is given in this chapter. The control codes are interpreted by 
part of the machine operating system called the VDU driver. 

The VDU drivers interpret all 32 ASCII control character codes. Many of 
the ASCII control codes are followed by a number of bytes. The number 
of bytes which follow depends on the function to be performed. The VDU 
code table summarises all the codes and gives the number of bytes which 
follow the ASCII control code. 

Detailed description 

4 This code causes text to be written at the text cursor, ie in the normal 
fashion. A MODE change selects VDU 4, normal operation. 

5 This code causes text to be written where the graphics cursor is. The 
position of the text cursor is unaffected. Normally the text cursor is 
controlled with statements such as 

PRINT TAB(5,10) 

and the graphics cursor is controlled with statements like 

MOVE 700,450 

Once the statement VDU5 has been given only one cursor is active (the 
graphics cursor). This enables text characters to be placed at any 
position on the screen. There are a number of other effects: text 
characters overwrite what is already on the screen so that characters can 
be superimposed; text and graphics can only be written in the graphics 
window and the colours used for both text and graphics are the graphics 
colours. In addition the page no longer scrolls up when at the bottom of 
the page. Note however that POS and VPOS still give you the position of 
the text cursor. 



Decimal 
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B | K 
C 

D M 
E N 
F 0 

10 P 

11 Q 

12 R 

13 S 


22 16 

23 17 

24 18 

25 19 

26 1A 

27 IB 

28 1C 

29 ID 

30 IE 

31 IF 
127 7F 


ASCII 

abbreviation 

Bytes extra 

NUL 

0 

SOH 

1 

STX 

0 

ETX 

0 

EOT 

0 

ENQ 

0 

ACK 

0 

BEL 

0 

BS 

0 

HT 

0 

LF 

0 

VT 

0 

FF 

0 

CR 

0 

SO 

0 

SI 

0 

DLE 

0 

DCl 

1 

DC2 

2 

DC3 

5 

DC 4 

0 

NAK 

0 

SYN 

1 

ETB 

9 

CAN 

8 

EM 

5 

SUB 

0 

ESC 

0 

FS 

4 

GS 

4 

RS 

0 

- US 

2 

DEL 

0 


Meaning 


Does nothing 
Reserved 
Reserved 
Reserved 

Write text at text cursor 
Write text at graphics cursor 
Enable VDU drivers 
Make a short beep 
Backspace cursor one character 
Forwardspace cursor one character 
Move cursor down one line 
Move cursor up one line 
Clear text area 

Move cursor to start of current line 

Page mode on 

Page mode off 

Clear graphics area 

Define text colour 

Define graphics colour 

Define logical colour 

Restore default logical colours 

Disable VDU drivers or delete current 

line 

Select screen mode 
Re-program display character 
Define graphics window 

PLOT K,x,y 

Restore default windows 
Reserved 

Define text window 
Define graphics origin 
Home text cursor to top left 
Move text cursor to x,y 
Backspace and delete 
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6 VDU 6 is a complementary code to VDU21. VDU21 stops any further 
characters being printed on the screen and VDU6 re-enables screen 
output. A typical use for this facility would be to prevent a pass-word 
appearing on the screen as it is being typed in. 


7 This code,whi ch can be entered in a program as VDU7 or directly from 
the keyboard as QjjlJ G, causes the computer to make a short ‘beep’. 


8 This code (VDU8 or H) moves the text cursor one space to the 

left. If the cursor was at the start of a line then it will be moved to the end 
of the previous line. It does not delete characters - unlike VDU 127. 


9 This code (VDU 9 or 
ter position. 


CTRL 


I) moves the cursor forward one charac - 


10 The statement (VDU 10 or ULu J) will move the cursor down one 
line. If the cursor is already on the bottom line then the whole display will 
normally be moved up one line. 


11 This code (VDU11 or UuJ K) moves the text cursor up one line. If 
the cursor is at the top of the screen then the whole display will move 
down a line. 


12 This code clears the screen - or at least the text area of the screen. 
The screen is cleared to the text background colour which is normally 
black. The BASIC statement CLS has exactly the same effect as VDU12 
or L. This code also moves the text cursor to the top of the text 

window. 


13 This code is produced by the key. However its effect on 

the screen display if issued as a VDU13 or PR I NT CH R$(13); is to move the 
text cursor to the left hand edge of the current text line (but within the 
current text window, of course). 

14 This code makes the screen display wait at the bottom of each page. 
It is mainly used when listing long programs to prevent the listing going 
past so fast that it is impossible to read. The computer will wait until a 
I^UiiAl key is pressed before continuing. This mode is call ed ‘pag ed 
mode’. Paged mode is turned on with the FfTTl N and off with (tildl 0. 


15 This code causes the computer to leave paged mode. See the 
previous entry (14) for more details. 


16 This code (VDU 16 or Qul P) clears the graphics area of the screen 
to the graphics background colour and the BASIC statement CLG has 
exactly the same effect. The graphics background colour starts off as 
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black but may have been changed with the GCOL statement. VDU 

16 does not move the graphics cursor - it just clears the graphics area of 
the screen. 

17 VDU 17 is used to change the text foreground and background 
colours. In BASIC the statement COLOUR is used for an identical 
purpose. VDU17 is followed by one number which determines the new 
colour. See the BASIC keyword COLOUR for more details. 

18 This code allows the definition of the graphics foreground and 
background colours. It also specifies how the colour is to be placed on the 
screen. The colour can be plotted directly, ANDed, ORed or Exclusive- 
ORed with the colour already there, or the colour there can be inverted. 
In BASIC this is called GCOL. 

The first byte specifies the mode of action as follows: 

0 Plot the colour specified 

1 OR the specified colour with that already there 

2 AND the specified colour with that already there 

3 Exclusive-OR the specified colour with that already there 

4 Invert the colour already there 

The second byte defines the logical colour to be used in future. If the byte 
is greater than 127 then it defines the graphics background colour 
(modulo the number of colours available). If the byte is less than 128 then 
it defines the graphics foreground colour (modulo the number of colours 
available). 

19 This code is used to select the actual colour that is to be displayed for 
each logical colour. The statements COLOUR (and GCOL) are used to 
select the logical colour that is to be used for text (and graphics) in the 
immediate future. However the actual colour can be re-defined with VDU 
19. For example 

MODE 5 
COLOUR 1 

will print all text in colour 1 which is red by default. However the 
addition of 


VDU 19,1,4,0/0,0 or VDU 19,1,4;0; 



108 VDU codes 


will set logical colour 1 to actual colour 4 (blue). The three zeros after the 
actual colour in the VDU 19 statement are for future expansion. 

In MODE 5 there are four colours (0,1,2 and 3). An attempt to set colour 
4 will in fact set colour 0 so the statement 

VDU 19,4,4,0,0,0 or VDU 19,4,4;0; 

is equivalent to 


VDU 19,0,4,0,0,0 or VDU 19,0,4;0; 


We say that logical colours are reduced modulo the number of colours 
available in any particular mode. 


20 This code VDU20 or 


CTRL 


T sets default text and graphic 


foreground logical colours and also programs default logical to actual 
colour relationships. The default values are: 


Two colour modes 
0=black 
1=white 


Four colour modes 

0=black 
l=red 
2=yellow 
3—white 

Sixteen colour modes 
0=black 
l=red 
2=green 
3=yellow 
4=blue 
5=magenta 
6=cyan 
7=white 

8=flashing black/white 
9=flashing red/cyan 
10=flashing green/magenta 
1 l=flashing yellow/blue 
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12=flashing blue/yellow 
13=flashing magenta/green 
14=flashing cyan/red 
15=flashing white/black 


21 This c ode behaves in two different ways. If entered at the keyboard 
U) it can be used to delete the whole of the current line. It is 


(as 


CTRL 


DELETE 


key many times. If the code is 


used instead of pressing the ___ 
generated from within a program by either VDU21 or PRINT CHR$ (21 ); it 
has the effect of stopping all further graphics or text output to the screen. 
The VDU is said to be disabled. It can be ‘enabled’ with VDU6. 


22 This VDU code is used to change MODE. It is followed by one 
number which is the new mode. Thus VDU22,6 is exactly equivalent to 
MQDE6 (except that it does not change HI MEM). 

23 This code is used to re-program displayed characters. The ASCII 
code assigns code numbers for each displayed letter and number. The 
normal range of displayed characters includes all upper and lower case 
letters, numbers and punctuation marks as well as some special symbols. 
These characters occupy ASCII codes 32 to 126. If the user wishes to 
define his or her own characters or shapes then ASCII codes 224 to 255 
are left available for this purpose. In fact you can re-define any character 
that is displayed, but extra memory must be set aside if this is done, and 
this is explained in Appendix D. 

ASCII codes 0 to 31 are interpreted as VDU control codes - and this 
chapter is explaining the exact function of each. Thus the full ASCII set 
consists of all the VDU control codes, all the normal printable characters 
and a user defined set of characters. 

For example if the user wishes to define ASCII code 240 to be a small 
triangle then the following statement would have to be executed. 


character to be 
re-defined 


VDU 23,24B, 1,3,7,15,31,63,127,255 

re-define 8 numbers giving the contents of each row of dots that 
character makes up the desired character 
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= 1 
2+1=3 
4+2+l=7 
8+4+2+1=15 


16+8 . . . .=31 


=63 


= 127 


=255 


As explained above the user may define any ASCII code in the range 224 
to 255. To display the resultant shape on the screen the user can type 

PRINT CHR$ (240) or 
VDU 240 

In the unlikely event of the user wishing to define more than the 32 
characters mentioned above (ASCII 224 to 255) it will be necessary to 
allocate more RAM for the purpose. 

24 This code enables the user to define the graphics window - that is, 
the area of the screen inside which graphics can be drawn with the DRAW 
and PLOT statements. The graphics screen is addressed with the 
following coordinates. 
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Thus the coordinates of A would be approximately 1000,200. 

When defining a graphics window four coordinates must be given; the 
left, bottom, right and top edges of the graphics area. Suppose that we 
wish to confine all graphics to the area shown below. 




The left hand edge of the graphics area has an X value of (about) 150. 
The bottom of the area has a Y value of 300. The right hand side has 
X=1100 and the top has Y = 700. The full statement to set this area is 

VDU 24,150;300;1100;700; 

Notice that the edges must be given in the order left X, bottom Y, right 
X, top Y and that when defining graphics windows the numbers must be 
followed by a semi-colon. 

For those who wish to know why trailing semi-colons are used the reason 
is as follows: X and Y graphic coordinates have to be sent to the VDU 
software as two bytes since the values may well be greater than 255. The 
semi-colon punctuation in the VDU statement sends the number as a two 
byte pair with low byte first followed by the high byte. 

25 This VDU code is identical to the BASIC PLOT statement.Only those 
writing machine code graphics will need to use it. VOU25 is followed by 
five bytes. The first gives the value of A referred to in the explanation of 
PLOT in the BASIC keywords chapter. The next two bytes give the X 
coordinate and the last two bytes give the Y coordinate. Refer to the 
entry for VDU24 for an explanation of the semi-colon syntax used. Thus 


VDU 25,4,100;500; 
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would move to absolute position 100,500. 

The above is completely equivalent to 

VDU 25,4,100,0,244,1 

X Y 

26 The code VDU 26 ([JJ31 Z) returns both the graphics and text 
windows to their initial values where they occupy the whole screen. This 
code re-positions the text cursor at the top left of the screen, the graphics 
cursor at the bottom left and sets the graphics origin to the bottom left of 
the screen. In this state it is possible to write text and to draw graphics 
anywhere on the screen. 

28 This code (VDU28) is used to set a text window. Initially it is possible 
to write text anywhere on the screen but establishing a text window 
enables the user to restrict all future text to a specific area of the screen. 
The format of the statement is 

VDU 28,LeftX,bottomY,rightX,topY 

where leftX sets the left hand edge of the window 

bottomY sets the bottom edge 

rightX sets the right hand edge 

topY sets the top edge 




For the example shown the statement would be 

VDU 28,5,20,30,12 
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Note that the units are character positions and the maximum values will 
depend on the mode in use. The example above refers to MODE1 and 
MODE 4. In MODES 2 and 5 the maximum values would be 19 for X and 
31 for Y since these modes have only 20 characters per line. 



29 This code is used to move the graphics origin. The statement VDU29 
is followed by two numbers giving the X and Y coordinates of the new 
origin. The graphics screen is addressed 



Thus to move the origin to the centre of the screen the statement 

VDU 29,640;512; 



114 VDU codes 


should be executed. Note that the X and Y values should be followed by 
semi-colons. See the entry for VDU24 if you require an explanation of the 
trailing semi-colons. Note also that the graphics cursor is not affected by 

VDU29. 


30 This code (VDU 30 or 
of the text area. 


CTRL 


A ) moves the text cursor to the top left 


31 The code VDU31 enables the text cursor to be moved to any 
character position on the screen. The statement VDU31 is followed by 
two numbers which give the X and Y coordinates of the desired position. 

Thus to move the text cursor to the centre of the screen in MODE 7 one 
would execute the statement 


VDU 31 ,20,12 

Note that the maximum values of X and Y depend on the mode selected 
and that both X and Y are measured from the edges of the current text 
window not the edges of the screen. 

32-126 These codes generate the full set of letters and numbers in the 
ASCII set. 

127 This code moves the text cursor back one character and deletes the 
character at that position. VDU 127 has exactly the same effect as the 


DELETE 


128-223 These characters are normally undefined and will produce 
random shapes. 

224-255 These characters may be defined by the user using the 
statement VDU2 3. It is thus possible to have 32 user defined shapes such 
as 

* VDU 23,224,8,28,28,107,127,107,8,28 

♦ VDU 23,2 25,8,28,62,127,62,28,8,0 

f VDU 23,226,54,127,127,127,62,28,8,0 
4VDU 23,227,8,28,62,127,127,127,28,62 


Try typing each of the lines above, remembering to press the llUIUdil 
key after each definition. To display any of the new definitions, type in 
the appropriate VDU code. For example, to display the heart, type 
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RETURN 


Character definitions 224 to 255 are stored in a block of memory 
reserved for them in the computer. If however, you need more 
characters, or you want to re-define some of the keyboard characters, the 
best way to do this is to tell the computer to set aside extra memory to 
store them. (If you don’t, you may run into problems). The operating 
system call *FX20 described in Appendix D enables you to do this. 
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Introduction 

Inside the Electron is a sound synthesiser which you can program to 
generate virtually any sound you like. The synthesiser is controlled by 
two BASIC commands: SOUND and ENVELOPE, and each command 
requires you to type in a series of numbers (or parameters) after it. These 
parameters determine the type of sound you will hear from the 
Electron’s internal loudspeaker; ie the type of sound, pitch, duration, 
and so on. 

There is a vast range of parameter values which gives you an almost 
unlimited range of possibilities when writing programs for the synthe¬ 
siser. However, you don’t need to be a wizard in order to use the sound 
system on a relatively simple level, and this chapter will serve to get you 
started. Once you’ve had some practice, read the last section in this 
chapter which goes into the SOUND commands in more detail. 


The SOUND command 

The SOUND command must be followed by four parameters which we 
will call Q, A, P and D. So the SOUND command takes the form 


SOUND Q,A 


D 


Selects SOUND channel number_ 

Switches the sound on/off or selects ENVELOPE 

Selects the pitch of the sound_ 

Selects the duration of the sound- 


Press 


ESCAPE 


and type the following: 


SOUND 1,-15,0,100 


RETURN 


This will produce a single tone of fairly long duration. Type this line in 
again and increase the P parameter (the third number). You’ll notice that 
the pitch increases. 
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The Q parameter 

There are four values of Q, and each one selects the SOUND channel 
number. 

Q=0 Channel 0, selects noise 
Q=1 Channel 1, selects tone 
Q=2 Channel 2, selects tone 
Q=3 Channel 3, selects tone 

You may wonder why there are three SOUND channels which all select 
tone as opposed to noise. The only reason for this is to make the sound 
system as compatible with the BBC Microcomputer as possible. From 
now on, we will ignore channels 2 and 3. 

The A parameter 

This parameter does three things, depending on the value you give it: 

When A is a negative number, the amplitude is at maximum, ie ‘on’. 
When A is zero, the amplitude is at minimum, ie ‘silence’. When A is 
between 1 and 16 inclusive, an ENVELOPE command of the same number 
is selected. Forget the ENVELOPE command for the moment, you will 
meet it later in this chapter. 

Note that for the sake of compatibility with the BBC Microcomputer, use 
A—-15 for ‘sound on’, and A=0 for ‘silence’. 

The P parameter 

The value of this parameter controls the pitch of the generated sound. 
The range of values are from 0 to 255, and each consecutive value will 
give a quarter-semitone pitch change. The lowest note (P=0) is the B one 
octave and a semitone below middle C, and the highest accurate note is 
the B above middle C (P—100). Although values above P=100 are not 
accurate to the even-tempered scale, they can still be put to good use for 
making sound effects. The table below is a quick reference guide to help 
you find the pitches you want. 



118 Making sounds 





Octave number 



Note 

1 

2 

3 

4 

5 

6 

B 

0 

48 

96 

144 

192 

240 

C 

4 

*52 

100 

148 

196 

244 *middle C 

C# 

8 

56 

104 

152 

200 

248 

D 

12 

60 

108 

156 

204 

252 

D# 

16 

64 

112 

160 

208 


E 

20 

68 

116 

164 

212 


F 

24 

72 

120 

168 

216 


F# 

28 

76 

124 

172 

220 


G 

32 

80 

128 

176 

224 


G# 

36 

84 

132 

180 

228 


A 

40 

88 

136 

184 

232 


A# 

44 

92 

140 

188 

236 



When the noise channel (channel 0) is selected, the P parameter has the 
following effect: 


P=0 Tone - 
P=1 Tone - 
P=2 Tone - 
P=3 Tone - 
P=4 Noise 
P=5 Noise 
P=6 Noise 
P=7 Noise 


high pitch 
intermediate pitch 
lpw pitch 

intermediate pitch 
short period 
intermediate period 
- long period 
intermediate period 


The D parameter 

The value of this parameter sets the duration of the tone in steps of 
50mS. So if D=100, then the duration will be (100 X 50)/1000, or five 
seconds. The maximum value of D is 254 (12.75 seconds). 


If D=-l, then the tone will carry on until it is turned off. 


Using the SOUND command in a program 

Before using the SOUND command in a program, try following through 
the example below, in order to produce a single sound. 

First of all, decide which channel to use: channel 0 will give noise, so use 
one of the three tone producing channels, say channel 1. So the first 
number is 1 - this is the value of Q. 
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Now choose the value for the second number - the A parameter. At the 
moment we aren’t using any ENVELOPES, and we want to hear the sound, 
so the next number is -15 - this is the value of A. 

The third number - the P parameter - determines the pitch. If you look at 
the pitch table, the C below middle C is the value 4. So P=4. 

How long shall the sound last? The fourth number - the P parameter - 
gives the duration in 50mS (five hundredths of a second). So for a 
duration of five seconds, P=100. 

Now type the following SOUND command with the number above: 


SOUND 1,-15,4,100 


RETURN 


This produces a tone which lasts for five seconds, and is the C below 
middle C. 

Remembering that the pitch value is in quarter semitone steps, then to 
produce the sound corresponding to C (one semitone higher than the 
previous one), we must increase the pitch value by four. 


SOUND 1,-15,8,100 


RETURN 


To play the next note up the scale, increase the P parameter by four 
again, and so on. 

Instead of using numbers in the SOUND command, you can incorporate 
the SOUND command into a program, and use real or integer variables 
(see chapter 11). For example, let’s produce a chromatic scale over an 
octave (equivalent to playing every note in sequence on a piano keyboard 
over an octave). 

Instead of having to type in 13 SOUND commands to get the 13 different 
notes in the scale, we can use a valuable for the P parameter, and change 
the variable value 13 times by using a FOR . . . NEXT loop. Try the 
program below which demonstrates this. 

5 REM chromatic scale starting at C below m 
idd le C up to middle C 
10 FOR X%=4 TO 52 STEP 4 
20 SOUND 1,-15,X%,5 
30 NEXT 
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Lines 10 and 30 set up a loop with variable X%, whose values are passed 
to the pitch parameter in line 20, Line 20 contains the SOUND command: 
channel 1 is selected, the sound is ‘on’ (A=-15), the pitch is determined 
by the value of X%, and each sound plays for 5 X 50mS, or 0.25 seconds. 

As you can hear, each new note only starts after the one before has 
finished. If you want to put a pause between each note, insert another 
SOUND command between lines 20 and 30, but turn it‘off by giving the A 
parameter value 0. The length of the pause will of course be decided by 
the value you give the last parameter. Try this line: 

25 SOUND 1,0,X%,10 

(Obviously, the pitch value here can be anything you like). Now list the 
program. 

5 REM chromatic scale starting at C below m 

iddle C up to middle C 

10 FOR X% = 4 TO 52 STEP 4 

20 SOUND 1,-15,X%,5 

25 SOUND 1,0,X%,10 

30 NEXT X% 

When you RUN this program, you will hear a pause between each note. 
Try changing the values of X% and the duration of the tones and pauses 
to get different effects. If you want to make a crude sequencer, put the 
complete program into a REPEAT . . . UNTIL FALSE loop. 

ENVELOPE 

Each SOUND command, as we have seen, allows you to generate a single 
tone, whose pitch and duration is defined by you within the SOUND 
command. The ENVELOPE command allows you to change the single tone 
into something far more complex. Try typing the following: 

10 SOUND 1,2,100,100 

If you run this, you will hear a continuous tone which lasts for five 
seconds. Now add this line: 


20 ENVELOPE 2,1,4,-4,4,10,20,10,0,0,0,0,0,0 
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When you run this program, you’ll hear a sound rather like a police siren. 
Ignore all the numbers after the ENVELOPE command, except for the very 
first one, which defines the ENVELOPE number, in this case 2. The second 
parameter in the SOUND command selects ENVELOPE number 2; 
(ENVELOPE 2,...); the third parameter selects the starting pitch and the 
fourth parameter selects a duration of five seconds. 

Note that once an ENVELOPE statement has been executed, it will stay in 
the computer until it is either re-defined, or until the computer is 
switched off. So even if you delete line 20 in the program above, when you 
run the program ENVELOPE number 2 will still be selected and used. 

The ENVELOPE command 

The ENVELOPE command is followed by 14 parameters, each separated 
by a comma. To make life easier, only the first eight actually do anything 
on the Electron, but the rest must be included for the sake of 
compatibility with the BBC Microcomputer. These eight parameters are 
shown below, and are followed by six zeros to make up the 14 parameters 
necessary. 

ENVELOPE n,s,Pi1,Pi2,Pi3,Pr1,Pr2,Pr3,0,0,0, 
0 , 0,0 

If you want to run Electron programs containing ENVELOPE statements 
on the BBC Microcomputer, then you should get into the habit of always 
using the following numbers for the last six parameters: 

ENVELOPE x,x,x,x,x,x,x,x, 126,0,0,-126,126,1 
26 

This will ensure that the resulting sound will be the same on both 
computers. For those of you who are not concerned with compatibility, 
use any numbers you like. In the rest of this section, ‘zeros’ have been 
used to save initially confusing you with too many numbers! 

The duration of the ENVELOPE effect varies, depending on the values in 
the ENVELOPE command. However, as long as the duration is less than 
that of its associated SOUND command, it will repeat itself until the 
SOUND command finishes. For example, if you set the duration of a 
SOUND command to five seconds and select an ENVELOPE which makes a 
‘WOW’ sound lasting for one second, then the result will be 
‘WOWOWOWOWOW\ With the ENVELOPE command, you can: 
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- Alter the SOUND pitch parameter by a specified increment 

- Specify how many increments you want 

- Set the length of time each increment ‘plays’ 

The length of each increment can only be specified once in the ENVELOPE 
command, but the increment value itself, and the number of increments 
can both be specified three times! 

Have a look at the graph below, which represents pitch plotted against 
time for an ENVELOPE command. As you can see, the resulting envelope 
contains three stages. In the first stage, the pitch increases by an 
increment of 1, then by -2 in the second stage, then 1 in the third stage. In 
the first stage there are seven pitch increments, in the second stage five, 
and in the third stage 12. (Notice that the duration of every pitch 
increment is the same). 


t 

PITCH 

VALUE 



The first eight parameters of the ENVELOPE command are as follows. 
First parameter n 

This is the ENVELOPE number, and is selected by the second parameter 
of the SOUND command. Values are from 1 to 16, 

Second parameter s 

This gives the duration of every pitch change in the ENVELOPE command, 
(ie all three stages), and each value corresponds to 10mS. Values are 
from 0 to 255. Values 1 to 127 give durations of 1 X 10mS to 127 X 10mS, 
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and when the ENVELOPE is finished, it repeats itself until the duration of 
the associated SOUND command has run out. Values 128 to 255 are 
equivalent to 1 to 127, except that at the end of the ENVELOPE, the 
final pitch is held until the associated SOUND command has run out. 

Third parameter Pil 

This gives the value of every pitch increment during the first stage. Values 
are from —128 to 127. 

Fourth parameter Pi2 

This gives the value of every pitch increment during the second stage. 
Values are from -128 to 127. 

Fifth parameter Pi3 

This gives the value of every pitch increment during the third stage. 
Values are from -128 to 127. 

Sixth parameter Prl 

This gives the number of pitch increments in the first stage. Values are 
from 1 to 255. 

Seventh parameter Pr2 

This gives the number of pitch increments in the second stage. Values are 
from 1 to 255. 

Eighth parameter Pr3 

This gives the number of pitch increments in the third stage. Values are 
from 1 to 255. 

Parameters 9 to 14 

These parameters must be put into the ENVELOPE command, but their 
values will have no effect on the effect produced by the Electron’s 
ENVELOPE command. In order to keep the command compatible with the 
BBC Microcomputer, these values should be 126,0,0,-126,126,126. 


Constructing an ENVELOPE 

Type in the following program: 

10 SOUND 1,2,4,50 

20 ENVELOPE 2 , 1 , 1 ,-2 , 1 , 7 , 5 , 1 2 , 0,0 , 0 , 0 , 0,0 
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If you run this, you will hear a whirring sound. The sound is being 
transmitted on channel 1 , ENVELOPE 2 is selected, the pitch value is 4, 
and the sound lasts for 50 X 50mS or 2.5 seconds. 

The graph below shows the effect of the ENVELOPE on the sound. This 
graph is exactly the same as the one at the beginning of this section on the 
ENVELOPE command, and was drawn using the parameter values in the 
ENVELOPE statement above. The parameters are as follows: 

n ENVELOPE number 2 
s Pitch change duration is 1 X 10mS 

Pil Stage 1 pitch changes INCREASE in increments of 1, (quarter 
semitones) 

Pi2 Stage 2 pitch changes DECREASE in increments of 2, (half 
semitones) 

Pi3 Stage 3 pitch changes INCREASE in increments of 1, (quarter 
semitones) 

PrI Number of pitch changes in stage 1 is 7 

Pr2 Number of pitch changes in stage 2 is 5 

Pr3 Number of pitch changes in stage 3 is 12 


t 

PITCH 

VALUE 



The total time taken for this ENVELOPE command is 10mS X total 
number of pitch changes, or 24 X 0,01 seconds, = 0.24 seconds. So the 
ENVELOPE is repeated over and over again, until the SOUND command 
finishes. 
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Additional SOUND features 

The first parameter of the SOUND command can be given extra values 
which provide you with some more facilities. To use these values, you 
must enter the first parameter as a four digit hexadecimal number (which 
must be preceded by a & sign, to tell the computer that a hexadecimal 
number follows). The four digits in this number can be represented by 
HOFC, and here is a description of each digit. 

H HOLD H = 0 for compatibility with the BBC Micro¬ 

computer. 

O Not used, but should be entered with a value of 0 for compatibility. 

F FLUSH F = 0 sound is queued. This means that the sound 

won’t start playing until the previous one has 
finished. This is only true if the previous sound is on 
the same channel as this one. If the channel 
numbers are different, then the latest SOUND 
instruction to be executed by the computer will 
immediately start playing in place of the previous 
one. 

F = 1 sound is not queued. This means that as soon 
as the sound is executed by the computer, any 
sound previously playing will immediately stop and 
be replaced by this sound. 

C CHANNEL C =■ 0 noise channel 

C = 1, 2 or 3 tone channels 

Example SOUND and ENVELOPE programs 

The program below turns the Electron into a keyboard instrument by 
using the 12345 and QWERTY keys. 

10 REM Keyboard - Caps Lock on! 

20 *F X12,4 
30 *FX11,4 

40 S$= " Q2W3ER5T6Y7UI9O0P" 

50 REPEAT 

60 SOUND &11,-15,INSTR(S$,GET$)*4,1 
70 UNTIL FALSE 
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This next program takes a string of note names, and plays the notes. 
The range of notes you can play is from the C below middle C, to the B 
above middle C. To produce the full range in sequence enter the 
following: cdefgabCDEFGAB (RETURN). This will give you two octaves in 
the key of C major. 

10 REM Tune player 

20 $$ = " c d ef g a bC D EF G A B" 

30 REPEAT 
40 INPUT "=>" T $ 

50 FOR N% = 1 TO LEN T$ 

60 P% = INSTR(S$,MID$(T$,N%,1)) 

70 SOUND 1,-15,P%*4,4 
80 NEXT 

90 UNTIL FALSE 

Laser Zap! This program uses an ENVELOPE with a downwards pitch 
sweep. To fire the laser, press any key. 

10 REM Zap! 

20 ENVELOPE 1,129,-15,-8,-3,10,10,10,126,0, 
0,-126,126,126 
30 REPEAT 

40 SOUND 811,1,255,5 
50 UNTIL GET = FALSE 

This last program uses a repeated ENVELOPE with an upwards pitch 
sweep to produce a spaceship take-off sound. 

10 REM Liftoff 

20 ENVELOPE 1,1,6,6,6,2,2,1,126,0,0,-126,12 
6,126 

30 FOR S% = 0 TO 220 
40 SOUND 1,1,SX,1 
50 NEXT 
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The Electron’s memory 

The computer’s memory consists of 65536 locations (0 to 65535), each 
containing 1 byte (8 binary digits). Half of the computer’s memory can be 
written to or read from (called RAM); the other half can only be read from 
(called ROM). 

Each location in memory has a unique address (like the address of your 
house) which is a four digit hexadecimal number. Location 0 in memory 
is &0000 and location 65535 is &FFFF. The & sign means that the 
numbers which follow are in hexadecimal. The easiest way to look at the 
computer’s memory is on a memory map. Overleaf is a simplified 
memory map for the Electron, showing on the right the address of each 
location. 

Looking at the memory map, see how it is divided into the two types, 
RAM and ROM. All the programming which went into making the 
machine work is stored in the upper half of the memory, from &8000 to 
&FFFF. Your BASIC programs are stored, unless the computer is told 
otherwise, starting at location &0E00. This position where the program 
starts is assigned to a resident variable called PAGE. PAGE is an address 
pointer; it tells the computer at which address to start executing a 
program when you tell it to RUN. The location at which the BASIC 
program finishes is also assigned to a variable, called TOP. If you type: 


PRINT 


TOP-PAGE 


RETURN 


the computer tells you how many bytes of memory your program fills. 

Note that future expansions of the Electron, eg a disc filing system, will 
move PAGE up. 

The next address pointer is LOMEM. This tells the computer where it can 
store the variables which are used by your program, and is usually the 
same value as TOP. 
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Memory map 


32K HAM 
to &7FFF ' 



Operating system ROM 


Memory mapped input/output 


Operating system ROM 


4 paged ROMs eg BASIC 

HIMEM 

RAM used for 
high resolution graphics 

BASIC stack | 

* 

LOMEM 

t. 

Dynamic variable storage a / 

TOP —* 

f . 

User’s BASIC program area 

PAGE -*> 



Reserved for operating 
system use 


Hex 

&FFFF 

&FF00 

&FC00 


Decimal 

65535 

65280 

61512 


&.C000 


49152 


I Movable boundary 


&8000 


32768 


h &4000 


16384 


&E00 

&0000 


8192 

3584 

0 


The last address pointer is HIMEM. HIMEM shows the position of the 
bottom of the screen memory, so any program or variables must be kept 
below this value. 
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Programs are normally loaded at &0E00, but they can be put higher up 
the memory by altering the value of PAGE. For example, if you make PAGE 
= &1000, and then you LOAD a program from tape, it will be situated at 
address &1000. When you do this, TOP and LOMEM are moved to their 
new position above the program. Another way in which to re-situate a 
program is to use ♦load. 

★ LOAD "program name" 1000 

will LOAD the program from tape into the memory at location &1000. 
This instruction does not alter PAGE, and if you want to run the program 
you must make PAGE = &1000. 

Any section of memory can also be saved by using *$AVE. 

★ SAVE "file name" SSSS FFFF EEEE fTiflim 

ssss is the hex address from which you wish to start saving. 

FFFF is the hex address plus 1 at which you wish to finish. 

EEEE is the hex address at which execution should commence. 

Indirection operators 

Individual memory locations can be accessed from BASIC by using three 
indirection operators: 

Symbol Purpose Number of bytes 

affected 

? Byte indirection operator 1 

! Double-word indirection operator 4 

$ String indirection operator 1 to 256 

To illustrate this, set a variable to an address in memory, for example: 

A = &1000 IsUliilLl 

?A will give the contents of location A, so the contents of location & 1000 
can be set by typing 

?a = 100 imniw 
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(Of course, because a location is a single byte, it cannot be set to a 
fractional number, or any integer above 255 decimal, which is &FF.Ifthis 
is done, the least significant byte is stored in the memory location 
specified.) 


To check the contents of &1000, type 


PRINT 


? A 


RETURN 


BASIC integer variables, such as age%, are stored in four consecutive 
bytes of memory, and four bytes can be accessed using !. 


! A 


70965 


RETURN 


Strings can be placed direct in memory, each character’s ASCII code 
being stored in 1 byte of memory. 


$A = "STRING" 


The $ indirection operator appends a carriage return to the end of the 
string, so the above command would give 6 bytes of ASCII code for the 
word ‘STRING’, plus a byte containing &D which is the ASCII code for 


RETURN 


Notice that the indirection operator is $A, and not A$ which is a BASIC 
string variable. The string in memory can, however, be assigned to a 
BASIC variable: 


RETURN 


Another way of using ? is with both a variable and a number. 

A?6 gives the contents of location A+6, in this case location &1006. 

To look at the contents of a group of memory locations, write a small 
program: 


10 FOR I = 0 TO 15 

20 PRINT "CONTENTS OF ";A+I; M ARE ";A?I 
30 NEXT 


The indirection operators described above are used and explained more 
thoroughly in the chapter on Assembly Language. 



24 User-programmable 
keys 

In the same way that liWLfl and the alphabetic characters give BASIC 
keywords at a single stroke, you can program the keys marked 1 to 0 to 
give any string you choose. 

For example, 

★ KEY 1 "*CAT " 

will cause 1 to print *CAT on the screen. 

Control charactersmay be^laced in the string, by typing the ! character. 
For example, M is i M, which performs the same function as the 

key. For a list of control characters, see Appendix A. So, 

★ KEY1 "*C AT j M " 

will cause 1 to print *CAT on the screen, and to set the command 

in operation. Therefore, a whole program, or a series of commands can be 
stored in one key. 

A useful routine is to have one key which returns the computer to MODE 
6 and lists the program in paged mode: 

*KE Y 0 "MODE 6 |M |N LIST \ M" 

Here is a key definition containing a small BASIC program: 

★ KEY 3 "10 REPEAT jM 20 PRINT CHRS (RNDC95) + 3 

1) ]M 30 UNTIL VP0S = 24 |M RUN JM" 

For the more advanced 

The key can be programmed also. It ta kes the v alu e 10. Th e 

following program cannot be stopped either by [223*3 or 

10 ON ERROR GOTO 30 
20 *KEY10 "OLD |M RUN [M" 

30 PRINT "YOU CAN'T STOP ME!" 

40 REPEAT UNTIL FALSE 
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ON ERROR is desc ribed in chapter 27. Actually, this program can be 
halted by pressing liffill IdJJJlf. 

BuJ LiiiiU is called a ‘hard reset’. It resets everything very nearly 
the way it was when the machine was first switched on. When you try it 
you’ll hear a beep and you’ll see that the ft reappears after the message 
at the top of the screen. 

133233 on its ow n is called a ‘soft reset’. It is roughly equivalent to 
pressing and entering the commands NEW and MODE 6. 

The soft reset does not clear the *KEY definitions for example. 

The five screen editing keys can also be re-defined, just like [33223 > 
after the issue of a *FX command. 

Keys can also be loaded with the contents of BASIC variables. The 
instruction which does this is OSCLI, which stands for operating system 
command line interpreter. It can be used with any operating system call 
from BASIC (distinguishable by a preceding asterisk), for example, 
*KEY, *SAVE, ♦LOAD, and so on. Each BASIC variable assigned to the 
KEY definition must be converted into a string, and the asterisk omitted, 
as follows: 

OSCLI "KEY" + S TR $ X + "LIST JM" 

This will put "LIST ! M" into KEY X, where X is a BASIC variable. 

There is no limit to the number of BASIC variables which may be used in 
an OSCLI assignment, provided that they are all either string variables, 
or are turned into strings using STR$. 
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This chapter contains a description of every word in the Electron BASIC 
language. These words are called ‘keywords’. 

The syntax of each keyword is shown, and an explanation of the form 
used is given below. 


u 




denote possible repetition of the enclosed 
symbols, zero or more times 

enclose optional items 

indicates alternatives from which only one 
should be chosen 


<num-const> means a numeric constant such as 4.7 or 112 

<num-var> means a numeric variable such as Y or width 


<numeric> means either a <num-const> or a <num- 

var>, or a combination of these in an 
expression, like 4*X+1 

<string-const > means a string enclosed in quotation marks like 

“JONCRAWFORD” 


<string-var> means a string variable, like A$ or NAME$ 

<string> means either a <string-const> or a <string- 

var>, or an expression such as A$ + “ELK” 

<testable condition> means something which is either TRUE or 

FALSE. Since both TRUE and FALSE have values, 
it is possible to use <numeric> instead of 
<testable condition> 


<statement> means any BASIC statement, like PRINT or 

GOSUB or PROC 

< variable name> means any sequence of letters or numbers 

which is an acceptable variable name 
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BASIC keywords 


ABS 

Abbreviation 

Description 


Examples 


Syntax 


None 


Absolute value 


FUNCTION 


This function gives the modulus; that is, it strips the 
minus sign from the number variable or expression 
following it. 

PRINT ABS(X) will give 2 if X is -2 

deviation = ABS(Temp1-Temp2) 
root — SQR(ABS(Y)) 

Brackets are optional where sense is not affected. 
<num-var> = ABS (<numeric>) 


ACS 

Abbreviation 

Description 


Examples 


None 


Arc-cosine 


FUNCTION 


Syntax 


This function gives the angle, between 0 and PI in 
radians, whose cosine is the number variable or 
expression following ACS. This expression must be 
between -1 and 1 inclusive. 

angle = ACS(0.5) 
course = ACS (—0.789) 

ANGLE = ACS(AD/HY) 

Brackets are optional where sense is not affected. 
<num-var> = ACS (<numerie>) 


ADVAL 


SOUND channel buffer status 


AD. 


Abbreviation 


FUNCTION 
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Description 

Examples 

Syntax 

AND 

Abbreviation 

Description 


Examples 

Comments 

Syntax 


Gives number of free spaces in SOUND buffers. ADVAL 
(—5) to ADVAL (—8) correspond to SOUND channels 0 

to 3 respectively. 

X=ADVAL(-7):PRINTFrBB spaces in ch. 2= ";X 

IF ADVAL{— 5)00 THEN SOUND 2, . . . 

<num-var> — ADVAL(<numeric>) 


Logical AND 

A. OPERATOR 

This is a logical operator which is most commonly used 
in an IF... THEN statement to combine two conditions 
and obtain a TRUE or FALSE result. 

False AND False gives False 
False AND True gives False 
True AND False gives False 
True AND True gives True 

If this result is TRUE the computer will go on to 
the statement following the THEN. If the result is FALSE 
the computer will go on to the statement following the 
ELSE, but if the ELSE is absent it will go on to the next 
line. 

IF X< 5 AND X>0 THEN PROCmiddle 

IF Z = 17 AND Y < 7 THEN PRINT 'YES'' ELSE PRINT 

"NO" 

AND may also be used in the conditional part of a 

REPEAT... UNTIL loop. 

<num-var> = <numeric> AND <numeric> 
<num-var> = <testable condition> AND 
< testable condition> 
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ASC 

Abbreviation 

Description 

Examples 

Syntax 

ASN 

Abbreviation 

Description 

Examples 

Syntax 

ATN 

Abbreviation 

Description 

Examples 


ASCH code 

None FUNCTION 

This function gives the ASCII character value of the 
first character in the string which follows it. If this 
string is null it gives -1. 

PRINT ASC("J0HN") will give 74 (see ASCH table) 

IF A$C(A$) = 78 THEN NEXT. 

X = ASC("m")*10 

Brackets are optional where sense is not affected. 
<num-var> = ASC ( < Cstring>) 


Arc-sine 

None FUNCTION 

This function gives the angle, between -PI/2 and PI/2 
in radians, whose sine is the number variable or 
expression following ASN. This expression must be 
between -1 and 1 inclusive. 

PRINT ASN(0P/HY) 
angle = ASN (0.5) 

Brackets are optional where sense is not affected. 
<num-var> == ASN (<numeric>) 


Arc-tangent 

None FUNCTION 

This function gives the angle, between -PI/2 and PI/2 
in radians, whose tangent is the number variable or 
expression following ATN. 

PRINT ATN (OP/AD) 
angle = ATN (-3) 
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Syntax 

AUTO 

Abbreviation 

Description 

Examples 

Comments 

Syntax 

BGET# 

Abbreviation 

Description 

Examples 

Syntax 


Brackets are optional where sense is not affected. 
<num-var> — ATN (<numeric>) 


Automatic line numbering 


AU. 


or 


FUNC 


COMMAND 


This command gets the computer to print t he next line 
number and a space each time you press 


RETURN 


The command has two optional parameters: the first is 
the starting line number, and the second is the interval 
between each subsequent line number. The default 
value of both these parameters is 10. 


AUTO 100,5 will give line numbers 100,105,110, 115 
etc. 

AUTO by itself will give line numbers 10, 20,30,40,50, 
etc. 


The largest allowable line number is 32767, and the 
largest allowable interval is 255. 


You must press 


ESCAPE 


to get out of the AUTO mode. 


AUTO[<num-const>[. <num-const>]] 


Read a byte from file 

B.# FUNCTION 

Reads a single byte from a previously opened file 
whose channel number follows (see chapter on file 
handling). 

byte—BGET# channel 
character = BGET# A 

<num-var> = BGET# <num-var> 
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BPUT# 

Abbreviation 

Description 

Examples 

Syntax 

CALL 

Abbreviation 

Description 

Examples 

Syntax 

CHAIN 

Abbreviation 

Description 


Store a byte to file 

BP.# STATEMENT 

Stores a single byte on a previously opened file whose 
channel number follows (see chapter on file handling). 

8PUT# channel, number 
BPUT# file, Z MOD 256 

BPUT# <num-var>, <numeric> 


Call assembled machine-code subroutine 

CA. STATEMENT 

Used from BASIC to call a previously assembled 
machine-code subroutine. Similar in operation to a 
PROC, being capable of passing parameters. Used in 
preference to a PROC where long calculation is in¬ 
volved, and speed is at a premium. 

30 CALL B2000 

70 fraction = &16A5 
80 CALL fraction 

150 CALL fraction, string$, number, integer%, ?byte 

CALL <numeric>{,<num-var> I <string-var>} 


Load and run a program 


CH. or 


FUNC 


K 


STATEMENT 


An instruction which LOADs and RUNs the program 
whose title is in the quotes. If the title is omitted the 
next program on the tape will be loaded. Can be used 
in one program to load another. NB all variables 
except the resident integer variables are cleared. 
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Examples 

CHAIN "PR0G1" 

CHAIN "" 

Syntax 

CHAIN <string> 

curs 

Character code 

Abbreviation 

CHR. FUNCTION 

Description 

Gives the character whose ASCII code is the number 
variable or expression following CHR$. 

Examples 

PRINT CHR$(32) 

A$ = A$ + CHR$(code%) 

Brackets are optional where sense is not affected. 

Syntax 

< string-var> = CHR$ (<numeric>) 

CLEAR 

Clear memory 

Abbreviation 

CL, STATEMENT 

Description 

This instruction takes away all the variable names in 
use, except the resident integer variables A% to Z%, 
and @%. 

Examples 

IF FNcrash > 30 THEN CLEAR 

Syntax 

CLEAR 

CLG 

Clear graphics screen 


Abbreviation 


None 


STATEMENT 
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Description 

Examples 

Comments 

Syntax 

CLOSE# 

Abbreviation 

Description 

Examples 

Comments 

Syntax 

CLS 

Abbreviation 

Description 

Examples 

Comments 

Syntax 


Fills the graphics screen with current graphics back¬ 
ground colour (which can be altered by the GCOL 
instruction). The graphics cursor is ‘homed’ to 0,0 
bottom left of graphics screen. 


IF X THEN CLG 


CTRL 


P has same effect. 


CLG 


Close a file 

CL0# STATEMENT 

Tells the computer you have completely finished with 
the file whose channel number follows (see chapter on 
file handling). 

CLOSE# (Channel) 

CLOSE# filel 

CLOSE#? closes all files. 

CLOSE# <numeric> 


Clear text screen 

None STATEMENT 

Fills text screen with current text background colour 
(which can be altered by the COLOUR instruction). The 
text cursor is homed to 0,0 the top left of the text 
screen. 


IF X THEN CLS 


CTRL 


L has same effect. 


CLS 
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COLOUR 

Abbreviation 

Description 


Examples 


C. or 


FUNC 


STATEMENT 


Used to select text screen foreground and background 
colour. 


Standard colours, with their logical values, in each 
mode are as follows: 


Foreground colour 

Background colour 

Logical no 

Actual colour 

Logical no Actual colour 

Modes 0,3,4,6 


v) 

Black (0) 

128 

Black (0) 

1 

White (7) 

129 

White (7) 

Modes 1,5 


0 

Black (0) 

128 

Black (0) 

1 

Red (1) 

129 

Red (1) 

2 

Yellow (3) 

130 

Yellow (3) 

3 

White (7) 

131 

White (7) 

Mode 2 


9 

Black (0) 

128 

Black (0) 

i 

Red (1) 

129 

Red (1) 

2 

Green (2) 

130 

Green (2) 

3 

Yellow (3) 

131 

Yellow (3) 

4 

Blue (4) 

132 

Blue (4) 

5 

Magenta (5) 

133 

Magenta (5) 

6 

Cyan (6) 

134 

Cyan (6) 

7 

White (7) 

135 

White (7) 

8 Flashing 

black/white (8) 

136 

Flashing black/white (8) 

9 Flashing 

red/cyan (9) 

137 

Flashing red/cyan (9) 

10 Flashing 

green/magenta (10) 

138 

Flashing green/magenta (10) 

11 Flashing 

yellow/blue (11) 

139 

Flashing yellow/blue (11) 

12 Flashing 

blue/yellow (12) 

140 

Flashing blue/yellow (12) 

13 Flashing 

magenta/green (13) 

141 

Flashing magenta/green (13) 

14 Flashing 

cyan/red (14) 

142 

Flashing cyan/red (14) 

15 Flashing 

white/black (15) 

143 

Flashing white/black (15) 


COLOUR takes one parameter, which is the logical 
value of the particular colour required, as given in the 
tables. 

COLOUR 2 
COLOUR 131 
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Comments 

Syntax 

cos 

Abbreviation 

Description 

Examples 

Syntax 

COUNT 

Abbreviation 

Description 

Examples 

Comments 

Syntax 


Colours used in each mode may be changed using 

VDU19;. 

See chapter 20 
COLOUR <numeric> 


Cosine 

None FUNCTION 

This function gives the cosine of an angle, which must 
be in radians. 

PRINT C0S(3.142) 

X=C0S(y) 

Brackets are optional where sense is not affected. 
<num-var> = COS (<numeric>) 


Count characters 

COU. FUNCTION 

Counts the number of characters printed using PRI NT 
since last carriage return. 

10 PRINT "Happy Birthday COUNT 

20 PRINT "Happy.Birthday COUNT 

>RUN 

Happy Birthday 15 
Happy 
Birthday 9 

Different from POS, which gives the position of the 
cursor from the left hand margin. 

<num-var> = COUNT 
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DATA 

Abbreviation 

Description 

Examples 

Syntax 

DEF 

Abbreviation 

Description 

Examples 

Syntax 

DEG 

Abbreviation 

Description 


Data in program 

D. STATEMENT 

This enables you to store information in a program and 
to recall it using a READ instruction. The information 
can be string or numeric. (See chapter on READ and 
DATA). 

10 READ A,B$,century 
20 DATA 3,GEORGE,18 

DATA <str-const> i<num-const> !<num-var>{, 
<str-const> [<num-const> l<num-var>} 


Define function or procedure 

None STATEMENT 

Informs the computer that an FN or PROC is about to 
be defined. (See chapters on procedures and functions.) 

10 DEF FNdouble(X) = X*2 

10 DEF PROCdouble 
20X = X*2 
30 ENDPROC 

DEF FN I PROC<name>[(<string -var> I 
<num-var>{, <string-var>l <num-var>})| 


FUNC 


Converts radians into degrees. 

angle =DEG(PI/6) 
angle =DEG{ACS(0.78)) 


Degrees 

FUNCTION 


Examples 
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Brackets are optional where sense is not affected. 
<num-var> = DEG<numeric> 


Syntax 

DELETE 

Abbreviation 

Description 

Examples 

Comments 

Syntax 

DIM 

Abbreviation 

Description 

Examples 

Comments 

Syntax 


Delete program lines 

DEL. COMMAND 

This command will delete a section of program from 
the first line number stated to the second inclusive. 
Cannot be used in a program. 

DELETE 100,150 

To delete a single line, just type the line number and 


RETURN 


DELETE <num -const>,<num-const> 


Dimension of an array 

None STATEMENT 

Informs the computer of how much memory to reserve 
for a named array. (See chapter on arrays.) 

DIM Date$(12,31) 

DIM X(100) 

DIM is also used to allocate space for machine-code 
programs. 

DIM <num-var> | <str-var> 

(<numeric>{, <numeric>}) 

DIM <num-var> <numeric> 
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DIV 

Abbreviation 

Description 

Examples 

Comments 

Syntax 

DRAW 

Abbreviation 

Description 


Examples 


Integer division 

None OPERATOR 

This tells the computer to divide one number into 
another using integer arithmetic; this means the result 
will always be a whole number. 

17 DIV 2 gives 8, ie the number of times that 2 can be 
subtracted from 17 with a positive or zero remainder. 

If numbers or variables are used which are not 
integers, then they will be truncated before the div¬ 
ision is carried out. 

8.1 DIV 2.9 gives 4. 

<num-var> = <numeric> DIV <numeric> 


Draw line on screen 


DR. or 


FUNC 


D 


STATEMENT 


Will draw a line from the previous coordinates of the 
graphics cursor to the new ones given, in all graphics 
modes (0,1, 2, 4 and 5). To move the graphics cursor 
use the MOVE instruction. 


The screen is always 0 to 1279 on the X axis and 0 to 
1024 on the Y axis, regardless of which graphics mode 
you are in. The line is drawn in the current graphics 
foreground colour which can be changed by using the 
GCQL instruction. 


10 MODE 4 
20 MOVE 0, 512 
30 DRAW 1279, 512 

will draw a horizontal line half way up the screen. 
See chapter 20 

DRAW <numeric>. <numeric> 


Syntax 
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ELSE 

Abbreviation 

Description 

Examples 

Syntax 

END 

Abbreviation 

Description 

Examples 

Syntax 

ENDPROC 

Abbreviation 

Description 

Examples 


EL. or 


FUNC 


E 


(See IF) 


Used to provide an alternative course of action if the 
result of an IF statement is false. 


IF A — d THEN PRINT "YES" ELSE PRINT "NO 
IF B THEN 100 ELSE 200 

IF <testable condition> THEN <statements 
ELSE <statement> 


None STATEMENT 

Can be used to halt execution of a program. Its other 
use is to reset TOP after a PAGE move. 

PAGE — EM600 : END 
60 IF finished THEN END 

END 


End of procedure 

E. STATEMENT 

This statement must conclude a DEF PROC as it tells 
the computer you have finished defining the pro¬ 
cedure. 

100 DEF PROCname 
110 REM statement 
120 REM statement 
130 ENDPROC 


Syntax 


ENDPROC 
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ENVELOPE 

Abbreviation ENV. STATEMENT 

Description This statement is used in conjunction with the SOUND 

statement to control the pitch of a sound. The ENV¬ 
ELOPE statement is followed by 14 parameters. 

ENVELOPE n,s,Pil,Pi2,Pi3,Prl,Pr2,Pr3,126,0 > 0,-126, 
126,126 

Parameter Range Effect 

n 1 to 4 Envelope number 

bits 0-6 0 to 127 Length of each step in 

1/100 of a second 


s bit 7 

0 or 1 

0 = auto-repeat the 
envelope 

1 = no auto-repeat 

Pil 

-128 to 127 

Change in pitch per step in 
section 1 

Pi2 

-128 to 127 

Change in pitch per step in 
section 2 

Pi3 

-128 to 127 

Change in pitch per step in 
section 3 

Prl 

0 to 255 

Number of steps in section 
1 

Pr2 

0 to 255 

1 

Number of steps in section 
o 

Pr3 

0 to 255 

z 

Number of steps in section 


3 

See chapter 22 

Syntax ENVELOPE <num-var>,<num-var> t <num-var>, 

< num-var>, <num-var>, <num-var>, <num-var>, 

< num-var>, <num-var>, <num-var>, <num-var>, 

< num-var>, <num-var>, <num-var> 
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EOF# 

Abbreviation 

Description 

Examples 

Syntax 

EOR 

Abbreviation 

Description 


Examples 

Syntax 


End of file check 

None FUNCTION 

This function is used to discover whether the end of an 
open file has been reached. The function gives a —1 if 
the end has been reached and a 0 if not EOF# must be 
followed by the channel number. 

IF EOF# (channel) THEN PROCclose 
REPEAT...:UNTIL E0F#(X). 

<num-var> = E0F#(<num-var>) 


Logical exclusive-OR 

None OPERATOR 

This is used in an IF.. .THEN or REPEAT... UNTIL 

loop to combine two conditions in the following way: 

False EOR False gives False 
False EOR True gives True 
True EOR False gives True 
True EOR True gives False 

In other words, if the results of the two conditions 
combined by an EOR are different then the result is 
true. 

IF A= 6 EOR B< 10 THEN GOSUB 420 

<num-var> — <numeric> EOR <numeric> 
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EQUB 

Abbreviation 

Description 

Examples 

Syntax 

EQUD 

Abbreviation 

Description 

Examples 

Syntax 

EQUS 

Abbreviation 

Description 


None STATEMENT 

Used to insert a byte of data into an Assembly 
Language program. EQUB can only be used inside the 
square brackets enclosing a piece of Assembly Lan¬ 
guage. 

EQUB 13 
EQUB A% 

EQUB <numeric> 


None STATEMENT 

Used to insert a double-word (4 bytes) of data into an 
Assembly Language program. EQUD can only be used 
inside the square brackets enclosing a piece of Assem¬ 
bly Language. 

EQUD 10000000 
EQUD F% 

EQUD <numeric> 


None STATEMENT 

Used to insert the ASCII values of a string into an 
Assembly Language program. EQUS can only be used 
inside the square brackets enclosing a piece of Assem¬ 
bly Language. 
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Examples 

Comments 

Syntax 

EQUW 

Abbreviation 

Description 

Examples 

Syntax 

ERL 

Abbreviation 

Description 

Examples 


EQUS "Too big" 
EQUS LS 


Used, among other things, for printing error messages 
in Assembly Language programs. Unlikethe indirect¬ 
ion operator $, EQUS does not add a 
the end of the string. 


RETURN 


(&D) to 


EQUS <string> 


None STATEMENT 

Used to insert a word of data (2 bytes) into an 
Assembly Language program. EQUW can only be used 
inside the square brackets enclosing a piece of Assem¬ 
bly Language. 

EQUW &FFE0 
EQUW Z% 

EQUW <numeric> 


Error line number 

None FUNCTION 

A function which gives the line number in which the 
last error occurred. 

X = ERL 

REPORT: PRINT " at line ";ERL 


<num-var> = ERL 


Syntax 
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ERR 

Abbreviation 

Description 

Examples 

Syntax 

EVAL 

Abbreviation 

Description 

Examples 

Syntax 

EXP 

Abbreviation 

Description 

Examples 

Syntax 


Error 

None FUNCTION 

A function which gives the numeric code for the last 
error which occurred. This is useful for error trapping. 

IF ERR = 17 THEN CLOSE# (channel) 

<num-var> = ERR 


Evaluate 

EV. FUNCTION 

Mainly used to enable you to type an expression, such 
as a mathematical equation, into the computer while a 
program is running. The equation is entered as a string, 
eg A$ = "COS(X/20)", and EVAL(A$) will work it out. 

A$ = "COS(X/20)" 

Y = EVAL(A$) 

<num-var> = EVAL (<string>) 

<str-var> = EVAL (<string>) 


Exponent 

None FUNCTION 

This mathematical function calculates the exponential 
e (2.7183 . . .) raised to any specified power. 

Y = EXP(X) 

ie Y = e to the power of X 
<num-var> = EXP (<numeric>) 


EXT# 


Reserved for future use. 
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FALSE 

Abbreviation 

Description 

Examples 

Comments 

Syntax 

FN 

Abbreviation 

Description 

Examples 


Syntax 


FA. CONSTANT 

This is a condition which the computer understands to 
be the number 0. If the computer decides a certain 
condition is false it will represent it as 0, and will act 
accordingly. 

REPEAT... :UNTIL FALSE 
IF A = FALSE THEN... 

PRINT 1=2 

gives 0, because 1 is not equal to 2, and so 1 = 2 is 

FALSE. 

<num-var> = FALSE 


User-definable function 

None Prefix 

FN is a prefix that identifies a function, both in a DEF 
statement and in a function call. 

10 INPUT A 

20 answer = FNsquare(A) 

30 PRINT answer 
40 END 

50 DEF FNsquare(number) = number*numbar 
DEF FNe = 2.7182818. 

DEF FN <name> [(<num-var>| <str-var>{, 
<num-var>j <str-var>})] 
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FOR 

Abbreviation 

Description 


Syntax 

GCOL 

Abbreviation 

Description 


F. STATEMENT 

FOR is used to initiate the control variable of the 
FOR... NEXT loop and will always take the following 
format: 

FOR _ (number or TO STEP 

(numeric variable) numeric variable) (n or nv) (n or nv) 

control variable start parameter finish increment 

parameter 

If the STEP is omitted it is assumed to be 1. 

When executing a FOR... NEXT loop the computer 
sets the control variable to the start parameter. 

Each time NEXT is encountered the computer increm¬ 
ents the control variable and loops back to the 
instruction just after FOR. This is repeated until the 
control variable is greater than the finish parameter. 
NB the increment can be negative. 

FOR <num-var> = <numeric> TO <numeric> 
[STEP <numeric>] 


Graphics colour 

GC. STATEMENT 

Used to select graphics screen foreground and back¬ 
ground colour, and to control effect of mixing colours. 
Takes two parameters, the second being the logical 
value of the colour required, the first the way in which 
two colours mix. 

Action of first parameter is as follows: 

0 Plot the colour specified 

1 OR the colour specified with those already on the 


screen 
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Examples 


Comments 


2 AND the colour specified with those already on the 
screen 

3 EOR the colour specified with those already on the 
screen 

4 Plot the logical inverse of the colour specified 

This mixing is carried out on a bit by bit basis. For 1,2, 
and 3, each binary digit in the plotted colour’s logical 
value is ORed, ANDed, or EORed with its respective 
digit in the screen colour’s logical value, to produce the 
logical colour which is to be plotted on that part of the 
screen. 

Inversion, 4, only involves the plotted colour, all its 
binary digits being inverted. In bit by bit logic, 0 is 
false and 1 is true. 

The truth tables for OR, AND, and EOR are as 
follows: 

0 OR 0 gives 0 
0 OR 1 gives 1 
1 OR 0 gives 1 
1 OR 1 gives 1 

0 AND 1 gives 0 
0 AND 0 gives 0 
1 AND 0 gives 0 
1 AND 1 gives 1 

0 EOR 0 gives 0 
0 EOR 1 gives 1 
1 EOR 0 gives 1 
1 EOR 1 gives 0 

GCOL 2, 1 

GCOL RND(5)-1, RND(8}-1 
GCOL, mix%, 129 

Colours used in each mode may be changed using 

V0U19; 

See chapter 20 

GCOL <numeric>,<numeric> 


Syntax 
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GET 

Abbreviation 

Description 

Examples 

Comments 

Syntax 

GET$ 

Abbreviation 

Description 

Examples 

Syntax 

GOSUB 

Abbreviation 

Description 


Get code from keyboard 

None FUNCTION 

This instruction causes the computer to read a char¬ 
acter from the keyboard buffer. If there is none, the 
computer will wait for a key to be pressed. It then gives 
the ASCII code for that key (see ASCII table) before 
continuing. 

Key = GET 

The keyboard buffer may be flushed by *FX15. 
<num-var> — GET 


Get character from keyboard 

GE. FUNCTION 

This instruction is the same as GET, but gives a string 
containing the character before continuing. 

Key$ = GET$ 

<string-var> — GET$ 


Go to a subroutine 

GOS. STATEMENT 

This instruction tells the computer to go to a sub¬ 
routine and start executing instructions from the 
specified line number until the instruction RETURN, 
when the computer must return to the instruction 
immediately after the GOSUB call. No more than 26 
nested subroutines are allowed. 
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Examples 

Comments 

Syntax 

GOTO 

Abbreviation 

Description 

Examples 

Comments 

Syntax 

HIMEM 

Abbreviation 

Description 


GOSUB 1000 

ON A GOSUB 10, 20, 30 

It is possible to use an expression, and brackets must 
then be used: 

GOSUB (10*A) 

but this will not work if the program is RENUMBERed. 
GOSUB <numeric> 


Go to a line number 


G. or 


FUNC 


G 


STATEMENT 


This instruction tells the computer to jump to the 
specified line number and start executing instructions 
there. 


GOTO 100 

ON A GOTO 10, 20, 30 

It is possible to use an expression: 

GOTO (10*A) 

but this will not work if the program is RENUMBERed. 
GOTO <numeric> 


H. VARIABLE 

Address pointer containing the address of the lowest 
location in memory used by the screen display. Its 
value may change depending upon which mode you are 
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Examples 

Syntax 

IF 

Abbreviation 

Description 

Examples 

Comments 

Syntax 


INKEY 

Abbreviation 

Description 

(i) 


using. No BASIC instructions or variables are stored 
above this point. HI MEM can be altered by the user, to 
preserve space for machine-code programs between 
BASIC and the screen. HIM EM contains the highest 
memory location that BASIC may use. This may be 
changed after a MODE statement. 

PRINT HIMEM 
HIMEM = 04000 

<num-var> ~ HIMEM 


Conditional IF 

None STATEMENT 

A word forming part of the IF ... THEN ... ELSE state¬ 
ment, IF must always be followed by a testable 
condition, and the result of this test (TRUE or FALSE) 
will control the subsequent action by the computer. 

IF A< 5 THEN... 

IF IQ > 140 THEN PRINT "GENIUS" 

IF A THEN 110 

means 

IF AO* THEN GOTO 110 

IF <testable condition> THEN <statement> 

IF <testable condition> THEN <line number> 
[ELSE <statement> [<line number>) 


None FUNCTION 

This instruction will wait a specified length of time for 
a key to be pressed before continuing. If a key is 
pressed its ASCII code is given but if no key is pressed 
a —1 is given. The number in brackets is the time delay 
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measured in 1/100 sec, and can have any value 
between 0 and 32767. 

Examples 

key = 1N KEY(100) 

Comments 

In fact, this instruction and GET, GETS, and 1 NKEY$ will 
actually test the keyboard buffer. This means that an 
IN KEY instruction will respond to any previously 
pressed key whose code has gone into this buffer 
(memory), even if you are not pressing it at this 
moment. 


To get over this problem the keyboard buffer can be 
flushed using a *FX15,1 instruction just before using 
IN KEY. Also, the autorepeat can be turned off by using 

*FX11,0. 

Description 

(ii) 

In addition to the above, the IN KEY instruction can be 
used to test for a single key directly. Using a negative 
number in the brackets, one for each key according to 
the table shown below, IN KEY gives —1 if the key is 
pressed, 0 if it is not. IN KEY used in this way does not 
read the buffer - it reads the key itself. See the table 
which follows. 

Examples 

IF IN KEY(—99) THEN... 

will be TRUE when the space-bar is pressed. 

Brackets are optional where sense is not affected. 



Syntax 
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Key 

Number 

Key 

Number 

A 

-66 

1 


-49 

B 

-101 

2 

» 

-50 

C 

-83 

3 

i 

-18 

D 

-51 

4 

: 

-19 

E 

-35 

£ 

> 

-20 

F 

-68 

6 

-53 

G 

-84 

1 

r 

-37 

H 

-85 

8 

-22 

I 

-38 

9 

-39 

J 

-70 

0 

-40 

K. 

-71 

- 

- 

-24 

L 

-87 

J 


-88 

M 

-102 

I 


-73 

N 

-86 



-103 

0 

-55 

* 


-104 

P 

-56 

/ 

-105 

Q 

-17 

SPACE BAR 

-99 

R 

-52 

1 

ESCAPE 

-113 

S 

-82 

l 

CAPS LKi^ 

-65 

T 

-36 


CTRL gull 

-2 

U 

-54 


SHIFT (MB 

-1 

V 

-100 


deletQ m 

-90 

w 

-34 


copyMH 

-106 

X 

-67 


returnTJ:' 

-74 

Y 

-69 

t 


-58 

Z 

-98 

1 

-42 





-26 





-122 


<num-var> = INKEY(<numeric>) 
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INKEY$ 

Abbreviation 

Description 

Examples 

Syntax 

INPUT 

Abbreviation 

Description 

Examples 

Syntax 

INPUT# 

Abbreviation 

Description 


INK. FUNCTION 

The same as IN KEY but gives the key as a character. 

Key$ = IN KEYS (100) 

Brackets are optional where sense is not affected. 
<string-var> = INKEY(<numeric>) 


I. or 


FUNC 


I 


STATEMENT 


This instruction halts the program, prints a ? on the 
screen, and waits for s ome information to be entered 
followed by 


RETURN 


INPUT must be followed by a variable. 


INPUT X 

INPUT name$, number 


Too complex for a simple description. 


Input from file 

I .# STATEMENT 

INPUT# is like INPUT, but instead of receiving 
information from the keyboard the computer takes it 
from a previously opened file. Must be followed by 
channel number (see chapter on file handling). 
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Examples 

Syntax 

INSTR 

Abbreviation 

Description 

Examples 

Syntax 

INT 

Abbreviation 

Description 


INPUT# channel, make$, price 
INPUT# C.B,A,Z$ 

INPUT# <num-var>, <num-var>l <string-var> 
{, <num-var>l<string-var>} 


In string 

INS. Includes ( FUNCTION 

This function will give the position of one string within 
another, the leftmost character position being 1. The 
search normally starts from the beginning of the string 
but an optional third parameter provides the facility to 
start the search from any specific character position. 
The number given by INSTR is the position of the 
second string within the first. A search for a null string 
(“”) will always give 1. If the search fails (the two 
strings are not the same at any position) then 0 is given. 

position = INSTR (first$, second$, start) 

PRINT INSTR("MONOTONOUS"/'ON") 

will print 2, whereas 

PRINT INSTR{"M0N0T0N0US"/'0N , ',3) 

will print 6 

<num-var> = !NSTR(<string>,<string> 
|,<numeric>]) 


Integer part 

None FUNCTION 

This function returns the next whole number below 
the value of the number variable or expression in 
brackets. In other words the number is truncated. 
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Examples 

Syntax 

LEFT$ 

Abbreviation 

Description 

Examples 

Syntax 

LEN 

Abbreviation 

Description 

Examples 

Syntax 


INT(1.7) is 1 
INT(—1.7) is -2. 
x= INT(Y) 

Brackets are optional where sense is not affected. 
<num-var> = I NT <numeric> 


Left string 

LE. Includes ( FUNCTION 

A function which gives the specified number of leftmost 
characters in a string. 

PRINT LEFT$ ("ELECTRON"^) 
will give ELECT 

A$ = LEFTS (B$,C) 

<string-var> = LEFTS (<string>, <numeric>) 


Length of string 

None FUNCTION 

A function which gives the number of characters 
(including spaces) in the specified string. 

PRINT LEN ("Donald Duck") 

will be 11 

Length = LEN(A$) 

Brackets are optional where sense is not affected. 
<num-var> = LEN(<string>) 
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LET 

Abbreviation 

Description 

Examples 

Comments 

Syntax 

LIST 

Abbreviation 

Description 

Examples 

Comments 


Syntax 


None STATEMENT 

This is an optional keyword which is used to assign a 
value to a variable. 

LET X = 10 has same effect as X = 10 

LET A$ = "JOHN” has same effect as A$ = "JOHN” 

May not be used with LOMEM, HIMEM, PAGE and 
TIME. 

LET <var> = <expression> 


or 


FUNC 


COMMAND 


This command instructs the computer to list the 
current program on the screen. It has two optional 
parameters which control the first and last lines to be 
listed. 


LIST 100,200 will list from 100 to 200 
LIST ,200 will list up to 200 
LIST 100, will list from 100 


Since LIST is a command it cannot be used in a 
program or in a multi-statement line. 


If you press 


CTRL 


N beforehand, LIST will list your 


program a screen-full at a time. When you want to see 


the next screen-full, press 
can be cancelled using 


SHIFT 


CTRL 


. This paged mode 


O. 


LI ST [ < num- const> |, | < num- const> ] 
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LISTO 

Abbreviation 

Description 


Examples 

Comments 

Syntax 

LN 

Abbreviation 

Description 

Examples 

Syntax 


List option 

None COMMAND 

This command must be followed by a number which 
controls the way in which a program is LISTed, as 
follows: 

9 List just as stored in computer’s memory 

1 Insert a space after each line number 

2 Indent FOR ... NEXT loops 

4 Indent REPEAT... UNTIL loops 

Any combination of the above may be obtained by 
adding the required values. 

LIST05 will insert a space after the line number and 
indent REPEAT... UNTIL loops. 

Since LISTO is a command it cannot be used in a 
program or in a multi-statement line. 

LISTO <num-const> 


Natural logarithm 

None FUNCTION 

A mathematical function to calculate the natural 
logarithm of the given number variable or expression. 

X = LN{Y) 

Brackets are optional where sense is not affected. 
<num-var> = LN<numeric> 
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LOAD 

Abbreviation 

Description 

Examples 

Comments 

Syntax 

LOCAL 

Abbreviation 

Description 

Examples 

Syntax 


Load program from file 


LO. or 


FUNC 


COMMAND 


A command which instructs the computer to LOAD the 
named program from the file. If the name is omitted 
then the next program is loaded. 


When the computer prints ‘Loading’ on the screen, the 
old program has been deleted and all variables cleared 
except the resident integer variables. 


LOAD "BUGZAP!" 

LOAD "" loads the next program (from tape only) 

During LOADing, the computer prints up the number of 
pages of memory being used, 

LOAD<string> 


Variable declaration 


LOC. or 


FUNC 


Q 


STATEMENT 


Informs the computer that the named variables are 
LOCAL to the PROC or FN in which they are declared. 


LOCAL variables are totally independent of variables 
with the same name outside the PROC or FN. 


LOCAL I 
LOCAL price% 

LOCAL<string-var>| <num-var>{,<string-var>l 
<num-var>} 
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LOG 

Abbreviation 

Description 

Examples 

Syntax 

LOMEM 

Abbreviation 

Description 

Examples 

Comments 

Syntax 

MID$ 

Abbreviation 

Description 


Common logarithm 

None FUNCTION 

A mathematical function to calculate the common 
logarithm of the given number variable or expression, 

V = LOG(X) 
rate — LOG (cone) 

<num-var> = LOG<numeric> 


LOM. VARIABLE 

Address pointer containing the address above which 
all the BASIC program’s variables are stored. It is 
usually set to be the same as TOP, but can be altered by 
the user at the start of a program, 

PRINT LOMEM 
0 LOMEM =&FA2 

If LOMEM is changed during program execution the 
computer will lose all its BASIC variables. 

LOMEM = <numeric> 

<num-var> = LOMEM 


Middle string 

M. Includes ( FUNCTION 

This function gives a subsection of a string; the 
position of the first character of the substring and the 
number of characters being specified. If the length is 
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Examples 

Syntax 

MOD 

Abbreviation 

Description 

Examples 

Comments 

Syntax 


omitted, the whole string to the right of the start 
position is given. 

PRINT MID$(Main$, start, length) 

PRINT MID$ ("MICROCOMPUTER",6,7) 
will be COMPUTE 

PRINT MID$("MICROCOMPUTER"^) 
will be COMPUTER 

X$ = MID$(A$,$,L) 

<string var> = MID$(<string>,<numeric> 
[,<numeric>]) 


Modulo 

None OPERATOR 

This function gives the remainder when an integer 
division is carried out. 

5 MOD 2 is 1 
55 MOD 5 is 0 
-1R MOD 4 is -2 
numerators MOD denominators 

If this function is used with decimal numbers or 
variables, these values are truncated before the divi¬ 
sion takes place. 

4.1 MOD 3.9 is 1. 

<num-var> = <numeric>MOD<numeric> 
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MODE 

Abbreviation 

Description 


Examples 

Comments 

Syntax 

MOVE 

Abbreviation 

Description 

Examples 


Graphics mode 


MO. or 


FUNC 


M 


STATEMENT 


Here is a list of the seven modes and their character¬ 
istics: 


Mode 

Graphics 

Colours 

Text 

0 

640X256 

2 

80X32 

1 

320X256 

4 

40X32 

2 

160X256 

16 

20X32 

3 

Text only 

2 

80X25 

4 

320X256 

2 

40X32 

5 

160X256 

4 

20X32 

6 

Text only 

2 

40X25 


This instruction tells the computer to change screen 
mode. Changing mode clears the screen and must not 
be used within a PROC or FN. MODE resets the value of 

HIMEM. 


MODE 0 
MODE x 
10 MODE mode 


Text coordinates change from mode to mode, but 
graphics coordinates are scaled to be the same in all 
graphics modes: 0 to 1279, 0 to 1023. 

MODE <numeric> 


Move graphics cursor 

MOV. STATEMENT 

This instruction moves the graphics cursor to any 
position, on or off the screen. 

MOVE 640, 512 
10 MOVE X,Y 
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Comments 

Syntax 

NEW 

Abbreviation 

Description 

Examples 

Syntax 

NEXT 

Abbreviation 

Description 

Examples 


The graphics origin may be moved to any position on 
or off the screen by using the instruction 

VDU29,X;Y; 

where X,Y are the coordinates you wish to become 0,0. 
See chapter 20 

MOVE <numeric>,<numeric> 


New program 

None COMMAND 

This command deletes a program from the computer’s 
memory by adjusting certain internal pointers. A 
program can be retrieved by typing OLD which resets 
the internal pointers, provided no new program lines 
have been entered and no new variables have been 
created. Since it is a command it cannot be used in a 
program or multi-statement line. 

NEW 

NEW 


N. or 


FUNC 


N 


STATEMENT 


This is used to step the control variable in a FOR . . . 
NEXT loop. The control variable after the NEXT is 
optional (see FOR). 


NEXT X% 
NEXT loop 
NEXT 


Syntax 


NEXT [<num-var>] {, <num-var>} 
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NOT 

Abbreviation 

Description 

Examples 

Comments 


Syntax 

OLD 

Abbreviation 

Description 

Examples 

Syntax 


Logical NOT 

None FUNCTION 

Normally used in conjunction with a testable condition 
to reverse the logic of the result, ie TRUE becomes 
FALSE and FALSE becomes TRUE. 

IF N0T(A=5) THEN money — 7R. 

TRUE and FALSE are represented as -1 and 0 respect¬ 
ively. 

NOT0 is - 1 , NOT—1 is 0. 

Beware of trying to use NOT with other values for 
TRUE. N0T1 is -2, which still acts as TRUE. 

<num-var> = NOT <numeric> 

<testable condition> = NOT (<testable condition>) 


0 . or 


FUNC 


0 (includes 


RETURN 


Old program 
COMMAND 


This command is used to recover a program which has 
recently been deleted by NEW, or by pressing the 


BREAK CTRL I BREAK 


OLD 

OLD 
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ON 

Abbreviation 

Description 


Comments 


None STATEMENT 

This instruction can be used in conjunction with GOTO, 
GOSUB and ERROR. 

Firstly GOTO and GOSUB. 

ON X GOTO 100, 300, 350, 470 

If X=1 then the program will go to 100. If X=2 then it 
will go to 300. If X=3 then it will go to 350 and so on. 

ON X GOSUB 475, 205, 310 

If X=1 then the program wilTgosub' 475. If X= 2 it will 
‘gosub’ 205 and so on. 

An ELSE can be included at the end to trap out of range 
values without causing an error. 

ON X GOTO 70, 190, 310 ELSE ENDPROC 

Secondly ERROR 

ON ERROR GOTO 1000 
ON ERROR RUN 
ON ERROR PROCerror 

This instruction is used for error trapping. This 
enables the program to deal with errors, rather than 
letting the computer halt the program and print up an 
error message. 

Errors may be accepted once again by typing 

ON ERROR OFF 

when the computer will halt and print messages as 
usual. 
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Syntax 


OPENIN 

Abbreviation 

Description 

Examples 

Syntax 

OPENOUT 

Abbreviation 

Description 

Examples 


ON <num-var> GOTO <numeric>{,<numeric>} 
or 

ON <num-var> GOSUB < numeric >{,< numeric >} 
or 

ON ERROR <statement> 
or 

ON ERROR OFF 


Open input file 

OP. FUNCTION 

This function opens a file from the current filing 
system, eg cassette to the computer and returns the 
channel number allocated by the computer’s file 
system. If the file does not exist then a 0 (FALSE) is 
returned. The file is opened for input only. See chapter 
on file handling. 

file = OPENIN "SCREENLOAD” 

X = OPENIN A$ 

<num-var> = OPENIN (<string>) 


Open output file 

OPENO. FUNCTION 

This function opens a file from the computer to the 
current filing system, eg cassette and returns the 
channel number allocated by the computer’s file 
system. If the file does not exist then one will be 
created. If a file of the same name already exists then it 
will be deleted and a new one created. The file is 
opened for output only. 

file = OPENOUT "SCREENDUMP" 

X = OPENOUT A$ 


Syntax 


<num-var> = OPENOUT(<string>) 
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OPENUP 

Abbreviation 

Description 

Examples 

Syntax 

OPT 

Abbreviation 

Description 


Open file for update 

None FUNCTION 

This function opens a file from the current filing 
system, eg cassette to the computer, in the same way 
as OPENIN. The file is opened for input and output 

edit “ OPENUP "Accounts" 

Z — OPENUP name$ 

<num-var> = OPENUP«string>) 


Assembly option 

None STATEMENT 

Used to select whether error messages are reported, or 
listings are given during assembly of a machine-code 
subroutine. OPT can only be used inside the square 
brackets enclosing a piece of Assembly Language. 

It may take eight different values of parameter: 

OPT 0 Report no errors, list no machine-code 
OPT 1 Report no errors, list the machine-code 
OPT 2 Report any errors, list no machine-code 
OPT 3 Report any errors, list the machine-code 

OPT 4 to OPT 7 are the same as OPTs 0 to 3 except that 
the machine-code is generated at the origin 0% 
instead of the program counter P%. 

50 OPT 2 

100 For I = 0 TO 3 STEP 3 
110 [OPT I 

120 ... . 

130 .... ] 

140 NEXT 


Examples 
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Comments 

Syntax 

OR 

Abbreviation 

Description 

Examples 

Syntax 

OSCLI 

Abbreviation 

Description 

Examples 


The second example above is commonly used in two- 
pass assembly, which will always give errors on the 
first pass. 

OPT <numeric> 


Logical OR 

None OPERATOR 

This is a logical operator which combines two testable 
conditions in the following way: 

False OR False gives False 
False OR True gives True 
True OR False gives True 
True OR True gives True 

IF A = 5 OR A = 10 THEN . . . 

IF Altitude OR B% THEN . . . 

IF X < 2 OR N0T(Y=4) THEN . . . 

<num-var> = <numeric> OR <numeric> 


Operating system command line interpreter 

OS. STATEMENT 

Used to pass BASIC valuables as parameters to 
operating system calls, such as *FX or *KEY. Must be 
used with a string, the variables being converted using 
STR$. The complete string must be the same as would 
be used normally, but without the asterisk. 

OSCU"FX”+STR$ action+","~t”STR$ parameter 
OSCU"KEY"+STR$ keynumber+keystringS 
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PAGE 

Abbreviation 

Description 

Examples 

Comments 

Syntax 

pi 

Abbreviation 

Description 

Examples 


PA. VARIABLE 

Address pointer containing the address above which 
the BASIC program is stored. It is usually set to &E00 
on cassette only machines, but can be altered by the 
user to locate more than one BASIC program in 
memory. 

PRINT PAGE 
PAGE = &16M 

The two least significant hex digits of PAGE are always 
zero - it points to the base of a page of memory, which 
always contains 256 bytes. 

PAGE = <numeric> 

<num-var> = PAGE 


None CONSTANT 

PI has the value 3.14159265 and can be used justlike a 
number. 

circumference = 2*PI*radius 
area — Pl*radius A 2 

<num-var> = PI 


Syntax 
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PLOT 


Plot graphics 


Abbreviation 

Description 


PL. or 


FUNC 


P 


STATEMENT 


The PLOT instruction is used to draw single points, 
lines, dotted lines and triangles. 


PLOT takes the form: 
PLOT A,X,Y 


which will plot at or to the point X,Y in the manner 
determined by the value of the first parameter A. 

The effect of the value of the first parameter is: 

0 Move relative to last point. 

1 Draw line relative in the current graphics fore¬ 
ground colour. 

2 Draw line relative in the logical inverse colour. 

3 Draw line relative in current graphics background 
colour. 


4 Move to absolute position. 

5 Draw line absolute in the current graphics fore¬ 
ground colour. 

6 Draw line absolute in logical inverse colour. 

7 Draw line absolute in current graphics background 
colour. 

Higher values of A have other effects which are related 
to the effects given by the values 0 to 7 

8-15 As 0-7 but with the last point in the line omitted 
in ‘inverting actions' 1 - eg using GCOL4. 

16-23 As 0-7 but with a dotted line. 

24-31 As 0-7 but with a dotted line and without the 
last point on the line. 

32-63 Are reserved for the Graphics Extension ROM. 
64-71 As 0-7 but only a single point is plotted. 
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Syntax 

POINT 

Abbreviation 

Description 

Examples 

Comments 

Syntax 

POS 

Abbreviation 

Description 

Examples 

Syntax 


72-79 Line fill. 

80-87 As 0-7 but plot and fill a triangle. When filling 
solid triangles with colour the computer fills the 
triangle between the coordinates given and the last 
two points visited. 

88-95 Line fill. 

See chapter 20 

PLOT <numeric>, <numeric>, <numeric > 


Point at graphics screen colour position 

PO. FUNCTION 

This function gives the logical colour at the specified 
point on the screen. If this point is off the screen then a 
-1 is given. 

colour = P0INT(X,Y) 

This function is used in the Marslander program to 
test whether the capsule has touched down, and 
whether it is on a flat surface. 

<num-var> = POINT {<numeric>, <numeric>) 


Position of text cursor 

None FUNCTION 

This function tells how far across the text screen the 
text cursor is . 0 is on the left, and the value to the right 
is determined by the mode, and by the size of text 
window. 

X = POS 

<num-var> = POS 
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PRINT 

Abbreviation 

Description 

Examples 

Comments 

Syntax 

PRINT# 

Abbreviation 

Description 

Examples 


Print on screen 


or 


FUNC 


/ 


STATEMENT 


This instruction is used for all character output to the 
screen. 


PRINT "Anywhere" 

PRINT A,B,length,moon$,BILL% 

PRINT HEIGHT*DEPTH:CHR$127; 99; 

PRINT CHR$X; is almost the same in operation and 
effect as VDUX, and the two are interchangeable. 

PRINT is also used to issue control-codes to the 
computer during program execution. 

PRINT CHR$9 will move the text cursor forward one 
square, for example. 

PRINT {["][,! ;]<string>l <numeric>}["][;] 


Print on file 

P.# STATEMENT 

PRINT# is like PRINT but instead of printing infor¬ 
mation to the screen it prints it on to a previously 
opened file. Must be followed by channel number (see 
chapter on file handling). 

PRINT# channel, make$, prices 
PRINT# C,B,A,Z$ 

PRINT# <num-var> {, <numeric > I < string>} 


Syntax 
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PROC 

Abbreviation 

Description 

Examples 

Comments 

Syntax 

FIR# 

RAD 

Abbreviation 

Description 

Examples 

Syntax 


Procedure 


FUND 


This prefix is used when defining a named procedure 
(see DEF) and to call this named procedure from 
anywhere in the program. 

PROCrotate 

IF . . THEN PROCfire 
DEF PROCfire 
PROCvolume(radius, height) 

PROC must be followed by a name without any spaces. 
Parameters may be passed in brackets. 

DEF PROC<variable-name>((<string-var> I 
<num-var>{,< string-var> I <num-var>}l 


Reserved for future use. 


Radians 


FUNC 


FUNCTION 


This function gives an angle in radians which is 
equivalent to the specified angle in degrees. There are 
2*PI radians in a circle of 360°. 


X = RAD(X) 
angle — RAD(angle) 
answer — SI N(RAD(angle)) 

Brackets are optional where sense is not affected. 
<num-var> = RAD <numeric> 
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HEAD 


Head data into variable(s) 


Abbreviation None STATEMENT 

Description This instruction tells the computer to copy infor¬ 
mation from a DATA statement into the variables which 
follow the READ instruction. The types of variables 
must match; numbers must be copied into numeric 
variables and strings into string variables. See DATA 
and chaper on READ and DATA. 


Examples READ name$, Tel, credit 

Syntax READ <num-var>l<string-var>{,<num-var>I 

<string-var>} 


REM 


Remark 


Abbreviation None STATEMENT 

Description This instruction tells the computer to ignore the rest of 

the program line, thus enabling the programmer to 
insert comments in the listing without affecting the 
program. 


Examples 10 REM Marslander 

1035 REM Move Alien 


Syntax 


REM < anything > 


RENUMBER 


Renumber program line 


Abbreviation 

Description 


REN. or 


FUNC 


8 


COMMAND 


This command has two optional parameters which 
control the way in which a program is to be re¬ 
numbered. The value of the first parameter is the 
starting line number. The second is the increment for 
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each subsequent line number. If either or both para¬ 
meters are omitted they will default to 10. 

Examples If a program looks like this 

10 xxx 
15 xxx 
17 xxx 
30 xxx 
32 xxx 

RENUMBER 100,5 will change it to 

100 xxx 
105 xxx 

110 xxx 
115 xxx 
120 xxx 

Comments This command also renumbers all GOTOs, GOSUBs and 

any other cross references, except calculated ones like 

GOTO (8*W) and GOSUB (100+Z). 

Syntax RENUMBER [<num-const>(,<num-const>]] 


REPEAT 

Abbreviation REP. or Y STATEMENT 

Description This instruction initiates a REPEAT . . . UNTIL loop 

which tells the computer to REPEAT a set of instruc¬ 
tions UNTIL a testable condition becomes true. 

REPEAT... U NTIL loops may be nested up to a depth of 
20 . 

Examples NOW “ TIME: REPEAT UNTIL TIME -NOW > = 500 


Syntax 


REPEAT 
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REPORT 

Abbreviation 

Description 

Examples 

Syntax 

RESTORE 

Abbreviation 

Description 

Examples 

Syntax 

RETURN 

Abbreviation 

Description 


REPO. STATEMENT 

This instruction will print up on the screen what the 
last error was, in words. 

REPORT: PRINT " at line ";ERL 

REPORT 


RES. or 


FUNC 


W 


STATEMENT 


This instruction restores the ‘DATA pointer’ to the 
beginning of a specified line. The DATA pointer points 
to the next piece of information to be read by a READ 
instruction. If no line is specified the DATA pointer is 
restored to the beginning of the first DATA instruction 
in the program. 


RESTORE 
RESTORE 2500 


RESTORE <numeric> 


Return from subroutine 

R. STATEMENT 

This instruction informs the computer that it has 
reached the end of a subroutine and that it must now 
RETURN to the instruction immediately after the 
GOSUB at which the subroutine was called. A sub¬ 
routine must not be exited other than by using 
RETURN. 
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Examples 

Comments 

Syntax 

RIGHTS 

Abbreviation 

Description 

Examples 

Syntax 

RND 

Abbreviation 

Description 


RETURN 

IF A=0 THEN RETURN 


Not to be confused with the 


RETURN 


key. 


RETURN 


Right string 

Rl. Includes ( FUNCTION 

A function which gives the specified number of right¬ 
most characters in a string. 

PRINT RIGHT$("FLAVOUR" f 3) will give OUR. 

<string-var> = RIGHT$(<string> I <numeric>) 


Random number generator 

None FUNCTION 

This function, which may be followed by a number in 
brackets, returns a random number. 

RND by itself generates a random whole number 
between -2147483648 and 2147483647 

RND(—X) gives the value -X and resets the random 
number generator to a number based on X. 

RND(0) repeats the last random number given by 

RND(1). 

RND(l) generates a random number between 0 and 
0.999999. 

RND(X) generates a random whole number between 
(and possibly including) 1 and X. 

The brackets are compulsory and must immediately 
follow the word RND with no intervening space. 
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Examples 

Syntax 

RUN 

Abbreviation 

Description 

Examples 

Comments 

Syntax 

SAVE 

Abbreviation 

Description 

Examples 


X = RND(IU) 

<num-var> = RND[(<numeric>)] 


FUNC 


R (includes 


RETURN 


STATEMENT 


This instruction makes the computer initiate execution 
of the numbered program lines in its memory. It also 
clears all variables except the resident integer vari¬ 
ables. 


RUN 

IF velocity >1011 THEN RUN 

A program can be RUN without clearing the variables 
by using the command GOTO, followed by the first line 
number. 

RUN 


SA. or 


FUNC 


STATEMENT 


This transfers the program from the computer’s 
current program area (between the system variables 
PAGE and TOP) on to cassette, and in future 
expansions, disc as well. When used with tape, SAVE 
must be followed by a name of up to 10 characters, 
inside quotation marks. 


SAVE "BUGZAP!" 


SAVE <string> 


Syntax 
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SGN 

Abbreviation 

Description 

Examples 

Syntax 

SIN 

Abbreviation 

Description 

Examples 

Syntax 

SOUND 

Abbreviation 

Description 


Sign 

None FUNCTION 

This function tells you whether the specified number, 
variable or expression is positive, zero or negative. 

The function gives: 

-1 for a negative number 
0 for a zero 

+ 1 for a positive number 

X = SGN(Y) 

Brackets are optional where sense is not affected. 
<num-var> = SGN(<numeric>) 


Sine 

None FUNCTION 

This function gives the sine of an angle, which must be 
in radians. 

PRINT SIN(3.142) 

X = SIN(y) 

Brackets are optional where sense is not affected. 
<num-var> = SIN(<numeric>) 


SO. STATEMENT 

Makes the computer generate a sound on the internal 
loudspeaker. 
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Syntax 

SPC 

Abbreviation 

Description 

Examples 

Syntax 

SQR 

Abbreviation 

Description 


The format is: 

SOUND Q,A,P,D 

Q is the channel number, 0 to 3. 

A is the envelope number, 1 to 4. If A is 0 then that 
sound channel is turned off. If A is negative (-1 for 
example) then a pure tone is produced. 

P is the pitch, 0 to 255. 

D is the duration, 1 to 255 in twentieths of a second. 
See chapter 22 

SOUND <numeric>,<numeric>,<numeric>, 
<numeric> 


Space 

None (See PRINT, INPUT) 

This statement is used in conjunction with PRINT or 
INPUT to give the specified number of spaces. This 
number may not be greater than 255. 

PRINT "Name";$PC(10);"Tel.";$PC(1|l);"CREDIT" 
INPUT "Amount" SPC(3) A 

Brackets are optional where sense is not affected. 

PRINT SPC (<numeric>) 

INPUT SPC (<numeric>) 


Square root 

None FUNCTION 

This function gives the square root of a positive 
number. 
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Examples 

Syntax 

STEP 

Abbreviation 

Description 

Examples 

Syntax 

STOP 

Abbreviation 

Description 

Example 


X = SQR(Y) 

ans = SQR(ABS(NUMBER)) 

Brackets are optional where sense is not affected. 
<num-var> = SQR(<numeric>) 


S. or 


FUNC 


(See FOR) 


This is part of the FOR . . . TO . . . STEP . . . NEXT 
statement. The number following STEP is the amount 
by which the control variable is incremented in each 
loop, and can be positive or negative, integer or real. 


FOR X = 0 TO 50 STEP 5 
FOR I = 10 TO 0 STEP -1 
FOR J = 7 TO 11.3 STEP Z*7 


FOR <num-var> = <numeric> TO <numeric> 
[STEP< numeric>] 


None STATEMENT 

This instruction has the same effect as END but it 
prints the message STOP, and the line number, on the 
screen. 

IF P >Temp THEN STOP 
STOP 


Syntax 
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SIRS 

Abbreviation 

Description 

Examples 

Syntax 

STRINGS 

Abbreviation 

Description 

Examples 

Syntax 

TAB 

Abbreviation 

Description 


String 

STR. FUNCTION 

This function converts any number or expression in 
the brackets into a string. STR$ has an opposite effect 
to that of VAL. 

A$ = STR$(X) 

B$ = STR$(—1.23) 

Brackets are optional where sense is not affected. 
<string-var> = STR$ (<numeric>) 


STRI. Includes ( FUNCTION 

This instruction produces a long string consisting of a 
specified number of copies of a shorter string. 

Line$ = STRING${40/'-") 

<string-var> = STRINGS (<numeric>,<string>) 


None (See PRINT, INPUT) 

Used with either PRINT or INPUT to set the position of 
the text cursor on the screen. 

TAB(X) will move the cursor forward to position X on 
the current line. X can be between 0 and 19,0 and 39, 
or 0 and 79 depending upon which mode is in use. 
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Examples 

Comments 

Syntax 

TAN 

Abbreviation 

Description 

Examples 

Syntax 

THEN 

Abbreviation 

Description 


TAB{X,Y) will move the cursor directly to position X,Y. 
The text cursor has its origin 0,0 at the top left. If a text 
window is in use, then TAB will treat the top left comer 
of that as 0,0. 

PRINT TAB(6.11); "HELLO" 

INPUT "How much" TAB(10), cost 

The brackets are compulsory, and there must be no 
space between TAB and (. 

PRINT TAB(<numeric> [,<numeric>]) 

INPUT TAB(<numeric> [,<numeric>]) 


T. FUNCTION 

This function gives the tangent of an angle, which must 
be in radians. 

PRINT TAN(PI/2) 
ratio — TAhl(.6) 

Brackets are optional where sense is not affected. 
<num-var> = TAN<numeric> 


TH. or 


FUNC 


T 


(See IF) 


Provides the course of action if the result of an IF 
statement is true. 

It is an optional keyword, but the program is neater 
and easier to follow when it is left in. 
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Examples 

Comments 

Syntax 

TIME 

Abbreviation 

Description 

Examples 

Syntax 

TO 

Abbreviation 

Description 

Examples 

Syntax 


IF A = B THEN PROCab 

THEN is not optional when assigning certain resident 
variables such as TIME, and when GOTO is omitted. 

IF<testable condition> THEN<statement>[ELSE 
<statement>] 


Tl. VARIABLE 

An integer variable which is incremented every 
hundredth of a second. It serves as an elapsed time 
clock, and can be set to any initial value by the user. 

TIME = 9 
T% = TIME 
PRINT T% 

TIME = <numeric> 

<num-var> = TIME 


None (See FOR) 

Used in the FOR ... N EXT loop to set the limiting value 
of the control variable. 

FOR I = 0 TO 11 

FOR<num-var> = <numeric> TO <numeric> [STEP 
<numeric>] 
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TOP 

Abbreviation 

Description 

Examples 

Syntax 

TRACE 

Abbreviation 

Description 

Syntax 

TRUE 

Abbreviation 

Description 

Examples 


None VARIABLE 

Address pointer containing the address of the first free 
memory location after the top of the BASIC program. 
TOP-PAGE will give the length of your BASIC program 

in bytes. 

PRINT TOP-PAGE 

<num-var> = TOP 


TR. STATEMENT 

Debugging device which prints BASIC line numbers in 
order of execution. Is turned on by TRACE ON, and off 
by TRACE OFF. TRACE X will only give line numbers 
below X. 

TRACE ON l OFF<numeric> 


None CONSTANT 

This is a condition which the computer understands to 
be the number -1. If the computer decides a certain 
condition is true, it will represent it as -1, and will act 
accordingly. 

IF A — TRUE THEN . . . 

Test = TRUE 



192 BASIC keywords 


Comments 


Syntax 

UNTIL 

Abbreviation 

Description 

Examples 

Syntax 

USR 

Abbreviation 

Description 


In practice, any number other than 0 is taken by the 
computer to be TRUE. Care is needed though. N0T(—1) 
is 0. N0T(1) is -2. This is because the NOT function 
simply inverts the binary digits, and does not consider 
them true or false at all. 

<num-var> = TRUE 


U. or 


FUNC 


U 


(See REPEAT) 


Conditional part of REPEAT... U NTIL loop. The loop is 
executed until the conditional statement after UNTIL 
goes true. 


REPEAT 

XXX 

XXX 

UNTIL X = 7 


REPEAT 

XXX 

XXX 

UNTIL 0 


These are 
the same 
and will 
loop forever 


REPEAT 

XXX 

XXX 

UNTIL FALSE 


UNTIL <testable condition> 


None FUNCTION 

Used from BASIC to call a previously assembled 
machine-code function. Similar in operation to an FN, 
but is not able to pass parameters. Used in preference 
to an FN where long calculation is involved, and speed 
is at a premium. 
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Examples 

Comments 

Syntax 

VAL 

Abbreviation 

Description 

Examples 

Syntax 

VDU 

Abbreviation 

Description 

Examples 

Comments 


X = USR(&1750) 

20 address — &30A9 
30 PRINT USR(address) 

See chapter on assembler. 
<num-var> — USR(<numeric>) 


None FUNCTION 

Gives the numeric part of a string as a number. The 
string must start with +, or a number, otherwise 0 is 
given. 

number = VAL(-762*12) 

will put number equal to -762. 

<num-var> = VAL(<string>) 


V. or 


FUNC 


V 


STATEMENT 


VDU has almost the same function as PRINT CHR$. It 
can be used to give any character or control code from 
the ASCII table in Appendix F. 


VDU5 Link text and graphics cursors. 
VDU8 Move text cursor back one square. 
VDU23 Re-define character. 


Sends code directly to the VDU drivers. Is quicker to 
type than PRINT CHR$. 

PRINT TAB(X.Y) is equivalent to 

VDU3LX.Y 
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Syntax 

VPOS 

Abbreviation 

Description 

Examples 

Syntax 

WIDTH 

Abbreviation 

Description 

Examples 


VDU <numeric> {, I ; <numeric>} [;] 


VP. FUNCTION 

Gives the distance of the text cursor from the top of the 
screen or text window. 

Y = VPOS 
PRINT VPOS 

<num-var> = VPOS 


W. STATEMENT 

Sets the width used by the computer to print on the 
screen. This is normally unlimited, and the computer 
runs on to the next line at the right boundary of the 
screen or text window. 

WIDTH 10 will cause the text to be printed in a column 
10 characters wide. 


Syntax 


WIDTH <numeric> 



26 Cassette file 
handling 


Aside from saving programs, data files can be opened on the cassette: for 
example to store addresses or telephone numbers. 

Here is a list of file handling commands which you can use: 


*CAT 

OPENIN 

OPENOUT 

OPENUP 

INPUT# 

PRINT# 

BGET# 

BPUT# 

EOF# 

CLOSE# 


Gives a catalogue of all data files and programs on 
the cassette. It takes a very long time on a cassette. 
Opens a file so that it can be read. 

Opens a new (empty) file for writing. 

Opens a file for reading or writing. 

Reads data from a file into the computer. 

Writes data from the computer into a file. 

Reads a single character (byte) from a file. 

Writes a single character (byte) to a file. 

Indicates whether or not the end of a file has been 
reached. 

Indicates to the computer that you have finished with 
a file. 


To create a data file, you must first open it using OPENOUT. OPENOUT 
must be assigned to a variable, as follows: 

A = OPENOUT "stamps" 

In this case, the file called ‘stamps’ has been opened, and is allocated to a 
variable called A. A becomes the communication channel to the file, and 
all data sent to the file is routed via A. For example, if you want to write 
the names of all your stamps into the file, you use PRINT#: 


10 A = OPENOUT "stamps" 

20 REPEAT 

30 INPUT "Give the name of the stamp" / name$ 
40 PRINT# A, nameS 
50 UNTIL nameS = "NO MORE" 

60 CLOSE# A * 
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So after the file has been opened, its name is not mentioned again. The 
above program will allow you to make a list of names and, if the cassette 
player is switched on, they will be recorded on tape. Notice that the file 
must be closed after use, with CLOSE#. 

To get the data back into the computer, you must open the file for 
reading using OPEN IN. (The tape must be wound to the start, of the file, 
and the PLAY button pressed). 

A = OPENIN "stamps" 

The variable name, in this case A, is completely arbitrary. You could 
equally well call it FRED, file, or anything else you wish. To read data 
from the tape into the computer’s memory, use INPUT#: 

10 A = OPENIN "stamps" 

20 REPEAT 

30 INPUT# A, name $ 

40 UNTIL name$ = "NO MORE" 

60 CLOSE# A 

Line 40 could equally well read: 

40 UNTIL EOF# A 

EOF# is a logical file operator which is TRUE when the end of the file has 
been reached. 

PRINT# and INPUT# are used to write or read strings to and from the 
cassette file. The instructions BPUT# and 8GET# are used to write and 
read single characters. 

*CAT may be used anytime to give a catalogue of all program and data 
files on tape, and * can be used as an abbreviation. 

Cassette operations print messages on the screen, and sometimes 
cassette operations wall produce errors. The message printed, and the 
computer’s reactions to errors can be altered using *0PT: 
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*0PT1 ,X controls all but the error messages which are printed on the 
screen. 

X = 0 Gives no messages. 

X = 1 Gives short messages (as normal). 

X — 2 Gives long messages, including load and execution addresses. 
*0PT2.X controls the computer’s action. 

X = 0 Lets the computer ignore all errors, and carry on regardless. 
Messages can still be given. 

X = 1 The computer asks you to try again by rewinding the tape (as 

normal). 

X = 2 The computer aborts the operation. 

*0PT3 ,X sets the inter-block gap in tenths of a second. This only applies 
to PRINT# and BPUT#. The gap on SAVE is fixed to 0.6 seconds. 

*0PT on its own sets all the values to normal. 
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So far you have seen that when the computer finds an error it halts 
execution of the program and prints a message on the screen. Some 
errors are generated by incorrect programming and these are the ones 
that you have to correct. But what about errors which occur during the 
execution of a good program, because either the data is wrong or the user 
inputs something that the computer cannot handle? 

Look at the following program: 

10 REPEAT 

20 INPUT "NUMBER", N 
30 L = LOG (N) 

40 PRINT "LOG OF ";N;" IS ";L 
50 UNTIL FALSE 

This is simple enough. It takes a number from the keyboard, and gives 
you the log of that number. But, if you type in a negative number, the 
program comes to a halt with: 

Log range at Line 30 

The same thing happens if you type 0, or a character such as W, or a word 
such as TWELVE. 

It is easy to trap such an error, and to print a message to tell the user what 
he or she has done wrong. Every error has an error number, which is 
stored in a variable called ERR. You will find a list of these errors in 
Appendix B. The number for the log error is 22, so we can alter the 
program as follows: 

5 ON ERROR GOSUB 100 
10 REPEAT 

20 INPUT "NUMBER", N 
30 L = LOG CN) 

40 PRINT "LOG OF ";N;" IS ";L 
50 UNTIL FALSE 

100 IF ERR = 22 THEN PRINT "MUST BE A POSIT 
IVE NUMBER > 0" 

110 RETURN 
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Now, if an illegal input is made, the program simply prints a message 
telling you what you have done wrong, and carries on run ning. The 
trouble is, it carries on running, a nd running , and running. The 
key has no effect. This is because 

has its own error code: 17. You’ll have to press _ 

to get the program back. 

To overcome this, RETURN can be incorporated into line 100: 


ESCAPE 


is treated as an error; it even 

then OLD 


100 IF ERR = 22 THEN PRINT "MUST BE A POSIT 
IVE NUMBER > 0":RETURN 


Now, the 


ESCAPE 


key works, but no message is printed to say what 


happened, or at what line. Don’t forget to delete line 110! 


To print the message, the instruction REPORT is used. 


110 REPORT 

will print the message Escape on the screen. 

The line number at which errors occur is stored in a variable called ERL. If 
you add a line 120: 

120 PRINT " at Line ERL 

then the correct message will be printed up on the screen. 

The above example is fairly simple, because there is only the one error 
which can occur. If you write a program that other people will use, you 
will have to think of all the possible errors that may occur, and trap them 
accordingly. In the example, the instruction used was 

ON ERROR GOSUB 


Other useful error trapping instructions are: 

ON ERROR GOTO 
ON ERROR PRINT 
ON ERROR PROC 

If you do use GOTO, you cannot ‘GOTO’ back again into a FOR ... NEXT 
loop, a REPEAT... UNTIL loop, or a function. See Appendix B for a list of 
errors and their codes. 
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Two methods are given here by which you can merge two BASIC 
programs which are stored on cassette, and in future expansions, disc as 
well. 

(i) This method requires you to LOAD one of the programs (preferably the 
shorter) and then to re-save it as an ASCII file using *SP00L You can 
then LOAD the other program; and the spooled program will be entered as 
the equivalent of keyboard input by loading it using *EXEC. Assuming 
that the two programs are called LARGE and SMALL, the procedure is as 
follows: 

LOAD "SMALL" 

Now set the tape recorder to a blank section of tape. 

★SPOOL "SMALL" 

LIST 

★SPOOL 

The program SMALL is now saved as an ASCII text file. 

LOAD "LARGE" 

★EXEC "SMALL" 

The merger is now complete. Any line numbers in LARGE that coincide 
with those in SMALL will be overwritten. If you want to add SMALL to the 
end of LARGE then you have to adjust the line numbers before SMALL is 
spooled. When you use *SP00L, anything that is output to the screen is 
also sent to the cassette. That is why you must type LIST. *SP00L without 
the file name closes the file that has been spooled. 

(ii) This is a slightly simpler method, but the line numbers of SMALL must 
be adjusted so as all to be higher than the highest line number in LARGE. 
The idea is to LOAD the program with the lower line numbers, and *L0AD 
the program with the higher numbers at TOP-2. Lastly, it is necessary to 
type END so that the computer can trace the lengthened program. 
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The procedure is: 

LOAD "LARGE" 

OSCLI "LOAD ""SMALL""" + STR$~(T0P-2) 
END 


This method is very easy, but you must be careful to adjust the line 
numbers. 
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Introduction 

The computer’s ‘brain’ has its own language, and that language is not 
BASIC. Every time you run a BASIC program, each line has to be 
translated before this brain {the computer’s central processor unit) 
can understand it at all. This translation is accomplished by a device 
called an interpreter, which resides in the computer’s memory. The 
action of this device need not concern you, but it is itself a program 
written in machine-code, and machine-code is the computer’s own 
language. 

There are 55 different instructions in machine code, which is about half 
the number of BASIC instructions available on the Electron. Each of 
these instructions acts upon one or more of the registers inside the 6502 
microprocessor (6502 is the type-number of this processor - it has no 
significance). A register is just like a byte of memory. The 6502 contains 
six registers, five of them being 1 byte long, and the last being 2 bytes 
long. These registers are not a part of the computer’s memory map (from 
location &0000 to &FFFF); they live an entirely separate existence in the 
heart of the microprocessor. But the machine-code instructions which 
control these registers are stored in the computer’s memory, in the 
position on the memory map labelled ‘operating system’. These instruct¬ 
ions don’t look much like intelligible commands, for they are simply 
binary numbers - 1010100100001010 for example. It is very difficult to 
program using such low-level instructions; even in hexadecimal they 
hardly look any better: A9 0A. This is the reason for using Assembly 
Language. 

Assembly Language uses a three-letter mnemonic to represent each 
machine-code instruction. Each mnemonic is a contraction of the action- 
in-words of that instruction. 

Take the instruction given above. One of the registers in the micro¬ 
processor is called the accumulator (all the registers will be described in 
detail in a moment). 

A9 means ‘load the accumulator’. 




Assembly Language 203 


The mnemonic for this is LDA, thereby giving you a rough guide to its 
function, LoaD Accumulator. 

The other part of the instruction, 0A, is 10 in decimal. So A9 0A means 
‘put 10 in the accumulator’, and this is written in Assembly Language as: 

LDA #10 

(The hash (#) tells the computer that it is the 10 which is to be put into 
the accumulator, and not the contents of memory location 10. This will 
be explained in a moment.) 

So, each of the 55 machine-code instructions is assigned a three-letter 
assembly mnemonic, which enables you the programmer to understand 
the function of each, without having to look it up on a chart. 

The Electron has another program in its memory, called an assembler, 
and this converts the Assembly Language directly into machine-code. 
During this assembly process, the computer can help you by giving error 
messages and a listing of the machine-code in hex. (If you were 
programming the 6502 direct in machine-code there would be no error 
messages at all - and just try finding a mistake among a few hundred 
machine-code instructions!) 

The assembler loads the machine-code into memory, and it can then be 
run, either as a CALL or USR from BASIC, or by using *RUN. 

Registers in the 6502 

The 6502 microprocessor has six registers as follows: 

Accumulator 

The accumulator is the main working register of the processor. Most of 
the 55 Assembly Language instructions operate on the accumulator, 
which gained its name from the way that results of arithmetic operations 
are ‘accumulated’. It is an 8-bit register, meaning that it can store and 
operate upon eight binary digits (one byte). Each bit is designated a 
number, from 0 for the least significant (rightmost) to 7 for the most 
significant (leftmost). 
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Common operations involving the accumulator are: 

- Loading it from memory (the locations &0000 to &FFFF). 

- Storing its contents in memory. 

- Addition or subtraction. 

- Logical functions (AND, OR, or EOR). 

- Shifting its contents left or right. 

Index registers X and Y 

The two index registers are each 8-bits long, and are used for the 
following: 

- To be added to the address used by an instruction. This is called 
indexing. 

- As general purpose registers for various counting or short term 
memory duties. 

- In addition to the above, both the accumulator and the two index 
registers are used by the Electron to pass parameters to operating 
system subroutine calls. This will be explained later. 

Program counter 

The program counter is the only 16-bit register, and it holds the memory 
address of the next instruction to be executed. 

Operations involving the program counter are: 

- Jump and branch instructions which alter the contents of the PC 
and thereby divert the flow of the program. (Much like GOTO in 
BASIC.) 

Stack pointer 

The stack pointer is an 8-bit register, with a ninth bit on the most 
significant end which is always set to 1. It is an address pointer which 
gives the location in memory of a special kind of data-structure used by 
computers called the stack. It can point to addresses between &0100 and 
&01FF. The stack is explained later, but in essence it is a section of 
memory which has not only a position, but also an order. Thus, data 
which is pushed on to the stack in one order, can only be pulled off it in 
the reverse order. This sort of memory is called last in first out (LIFO). It 
is used for storing data in which the order is important, eg execution 
addresses of nested subroutines. 
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Flags register 

The flags register is different from all the others in that it operates as 
seven single-bit. registers: N, V, B, D, I, Z, C. Each bit signals a condition 
in the processor, and certain instructions act upon these conditions 
(whether that condition is present, true; or is not present, false). 

Each bit acts as follows: 


Bit N is set to 1 when the last operation produced a negative result. A 
negative result is signified by the most significant bit of a register being 1 
(the sign bit). In the case of the accumulator, a result inside it of, for 
example, 10010100 would set bit N of the flags register to 1. If the last 
operation did not produce a negative result then bit N is reset to 0, 

Bit V is set to 1 when the last operation overflowed into the sign bit. As 
stated above, the sign bit is bit 7 in the case of the accumulator, so bit V is 
set to 1 when there is a carry from bit 6 to bit 7. This is important to know 
when using twos complement arithmetic, for it means that- an error has 
occurred which must be corrected. 


Bit B is set to 1 when the BRK command is used (break). (This command 


has much the same effect on a machine-code program that 
on a BASIC program.) 


ESCAPE 


has 


Bit D, when set to 1, causes the processor to operate in BCD mode 
(binary coded decimal). When reset to 0, the processor works as normal 
in binary. BCD is beyond the scope of this book, and need not concern 
you. 

Bit I is the interrupt mask. When it is set to 1 no interrupts are accepted. 
Interrupts are also beyond the scope of this book. 

Bit Z is set to 1 when the last operation produced a zero result. 


Bit C is the carry register. It is set to 1 by a carry from the most significant 
bit of one of the registers, usually the accumulator. 

These flags are used by the branch instructions, which direct the flow of 
the program according to the conditions. For example, BEQ means 
‘branch if equal to zero’. The program will branch if the Z bit is set to 1. If 
not it will not branch. 
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Addressing modes 

Take a single instruction - you have seen LDA before. Its function is 
always to ‘load the accumulator’, but it may load it in different ways and 
from different places according to which addressing mode is used. 

LDA #10 

means ‘load the accumulator with 10’. You know that already. However, 

LDA 10 

means ‘load the accumulator with the contents of memory location 10’. 

This is an example of two different addressing modes. The first is 
immediate addressing. The instruction uses the data immediately, 
without looking for it in memory. The second is zero-page addressing. 
The instruction uses the contents of the address specified. It is called 
zero-page because the computer’s memory is divided up into 256 pages 
each of 256 bytes. Any address which has its two most significant hex 
digits as zero is said to be in the zero-page of memory. The zero-page 
extends from locations &0000 to &00FF. 

LDA may also be used with a full 16-bit address: 

LDA &30A7 

will ‘load the accumulator with the contents of memory location &30A7’. 
This addressing mode is called absolute. It can access any location in the 
computer’s memory. Notice that the assembler treats numbers as 
decimal, unless they are preceded by &. 

Immediate, zero-page and absolute are not the only addressing modes, 
although they are the most simple to understand. 

LDA &1D77,X 

is an indexed addressing mode. 

The address used by the instruction is &1D77 plus the contents of index 
register X. So the accumulator is not loaded from &1D77 but from 
&1D77+X. Note that the contents of index register X are added to the 
address, and not to its contents. 
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The index register used can equally well be Y: 

LDA &2500.Y 

(Note: When using machine-code there are several subdivisions of the 
above indexed addressing mode, but using the assembler takes care of all 
those for you. However, the assembled machine-code (in hex) will not 
always be the same for the same indexed instruction.) 

Another still more complicated addressing mode is indirect addressing: 

LDA (&1B.X) 

The address given after the assembler mnemonic, in this case &1B, must 
be a location in the zero-page of memory (or an error will result). This 
location is then added to the contents of the X register, to give another 
location in the zero-page. The contents of this new location, and the 
contents of the location above it, together supply the full 16-bit address 
of the location from which the accumulator is loaded. So, if &1B+X 
contains &AA, and &1B+X+1 contains &BB, then the accumulator will 
be loaded with the contents of memory location &AABB. 

The above operation is called pre-indexed indirect addressing; the 
indexing is the addition of the X register, and the direction is the use of 
the two consecutive locations at the intermediate address as an address 
pointer to the actual location used. It is called pre-indexed indirect 
because the indexing is done before the indirection. All pre-indexed 
indirections must use index register X. 

Post-indexed indirect addressing is written in Assembly Language as 
follows: 

LDA (&27).Y 

In this addressing mode, the indirection occurs first. The address given 
after the assembler mnemonic, in this case &27, must again be a location 
in the zero-page of memory. The contents of this location and the 
contents of the location above it together give a 16-bit address. To this 
16-bit address is added the contents of index register Y, and this final 
address is the location from which the accumulator is loaded. All post- 
indexed indirections must use index register Y, 
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The above examples show the complete range of addressing modes 
which can be used with the instruction LDA. However, there are three 
more important addressing modes which are used with certain other 
instructions. 

All of the branch instructions use a relative addressing mode. BEQ was 
mentioned in the description of the flags register; it means ‘branch if 
equal to zero’. A branch is an instruction which has an offset: 

III data 
BEQ Label 
AAA data 
BBB data 
.Label CCC data 
ODD data 

In this fragment of program, the triple-letters can be any assembler 
instructions. When a program is running, the program counter is 
incremented one step at a time to point at the next location which is to be 
executed. In this example, when BEQ Label is being executed the 
program counter will point to the line containing the instruction marked 
AAA. If the result of checking the Z flag is that the previous operation did 
not produce a negative result then execution will continue at the line 
containing AAA. If the previous operation did give a zero result then the 
program counter is incremented until it points at the line marked Label. 
This program illustrates the use of labels in assembler. They can take 
any name that you choose (subject to the same limitations as a BASIC 
variable name), and are signified by the fact that they must always start 
with a full stop. 

Branch instructions may branch to labels either forwards or backwards, 
but not too far. The actual distances are 128 bytes backwards or 127 
bytes forwards; but remember that these are measured from the next 
instruction following the branch, and that each instruction may be either 
1, 2, or 3 bytes long. The assembler will soon tell you if you have an 
address or label out of range. 

The next addressing mode is accumulator addressing, which is used by 
only four instructions in the 6502 set. These are ASL, LSR, ROL, and ROR, 
and their action is explained in the reference section. In essence, they 
shift the bits of a memory location or the accumulator to the left or right. 
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ASL &760 

means shift the contents of memory location &760 one bit to the left. In 
order to apply this instruction to the accumulator, the accumulator’s own 
addressing mode is used: 

ASL A 

means shift the contents of the accumulator one bit to the left. Look up 
the four instructions in the reference section for more information. 

The final addressing mode which you need to know about is the simplest. 
Certain instructions, such as BRK (break) do not need any data or 
memory reference at all. These are called implied instructions and they 
carry out a simple task, usually on one of the registers; for example CLC 
meaning ‘clear the carry flag’. 


Addressing mode 

Examples 


Immediate 

LDA #68 

LDA # number 

Zero-page 

LDA &9B 

LDA address 

Absolute 

LDA &8E17 

LDA address 

Indexed 

LDA &A06C.Y 

LDA table,X 

Pre-indexed indirect 

LDA (&72.X) 

LDA (pointer,X) 

Post-indexed indirect 

LDA (&|J0),Y 

LDA (zero),Y 

Relative 

BEQ Repeat 

BNE Loop 

Implied 

CLC 

BRK 

Accumulator 

LSR A 

ROL A 


The examples on the right show the assembler mnemonics used not with 
specific addresses, but with BASIC variables. You will find out that this 
is a good way of writing assembler subroutines which are to be called 
from within BASIC programs by CALL or USR. 

One final point about addressing modes. The JMP (jump) instruction is 
the only one which allows straight indirect addressing (non-indexed). 
JMP is very similar to BASIC’s GOTO. It can take a full 16-bit address 
and place this value in the program counter - hence the program jumps 
to a new execution address. It is usually used with a label, just like 
branch, but without the restriction on distance. In absolute mode it 
would look like this: 
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JMP Label 

If you wish to use it in indirect mode then simply enclose the address in 
brackets: 

JMP (&21 A7) 

It will then use the contents of the two consecutive locations at &21A7 as 
an address pointer to the location to which it will jump. 

JMP &21A7 


&21A7 &32 

&76 


&3276 continue execution. 

Entering assembly mnemonics 

This section tells you how to write Assembly Language subroutines, and 
how to call them from BASIC. You may find it worthwhile, now that you 
know about the 6502 processor’s make-up, to read all of the assembly 
mnemonic definitions. You will then be able to understand much more 
clearly the capability of the processor, and what the short programs in 
this section are doing. 

Sections of Assembly Language are entered as part of a BASIC program, 
separated from the BASIC part by the square brackets [ and ]. The 
general structure of a program containing an assembler routine is: 

10 REM BASIC program 

100 [ 

110 \ Start of assembler mnemonics 

200 ] 

210 REM BASIC program continues 
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Notice that remarks in the Assembly Language section are signalled by a 
backslash \ . The assembler then knows to ignore them. 

Before the routine can be assembled, the computer must be told where it 
is to be put in computer memory. So the first line of the BASIC part must 
allocate some memory for this purpose, and there are two ways in which 
you can do this. 

On entering the assembler routine, you assign to the resident integer 
variable P% the value you choose to be the address of the first instruction 
of the assembled machine code. P% is the ‘pseudo program counter’, 
used by the assembler, to calculate addresses for branch and jump 
instructions and as the pointer for the assembled codes. (When 0% is not 
being used). 

The two methods for doing this are; 

(i) By direct assignment : P% — &2000 for example. The problem with 
direct assignment is that you have to ensure that the memory location 
chosen is available for use. 

The second method gets round this problem. 

(ii) By using the BASIC DIM instruction. This takes the form DIM P% 
100 . Note the use of spaces, and no commas or brackets, to distinguish it 
from an array dimension. DIM P% 100 allocates 101 bytes of memory for 
the machine-code, which will be stored along with all the BASIC 
variables above LOMEM. The number used with the DIM instruction 
must be large enough so that sufficient space is reserved to hold all the 
code, but not so large as to overlap other items in the memory. 

An even better way in which to use DIM is: DIM Q% 100 followed by P% 
=Q%. DIM is a convenient way of reserving space for machine code 
routines. No check is made to prevent the assembled code from 
overrunning the space reserved for it. 

Assembly 

To get the computer to assemble the routine into machine-code, you 
simply RUN the program. To complete the assembly, the program has to 
be RUN twice. The reason for this will become clear in a moment. The 
assembler pseudo-operator OPT controls the listing and error output 
generated on assembly. This operator must be placed in the assembler 
routine, usually at the start, and is followed by a number from 0 to 3 
which causes the following outputs: 
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OPT0 No errors printed, no listing given. 

0PT1 No errors, but a listing is given. 

0PT2 Errors are printed, but no listing. 

0PT3 Both errors and a listing are given. 

The listing given is of the machine-code, in hexadecimal. The errors are 
printed as messages on the screen, 

Here’s an Assembly Language routine: 

Id DIM Q a /a Idd 

2d p% = a% 

3d [0PT3 
4d LDA &70 
5d CMP #d 
60 BEQ Zero 
7d STA &72 
80 .Zero RTS 
9d ] 

When you RUN this program, the computer will print a listing, and then 
the message: 

No such variable at line 6d 

Routines which have forward reference to labels (Zero is referred to on 
line 60 when the assembler has not yet come across it) will always 
generate an error. The answer to this is to inhibit errors the first time 
through by using OPTd, and then to RUN a second time to generate the 
complete code. This is called two-pass assembly. 

The way to do this is to enclose the routine in a FOR. . .NEXT loop as 
follows: 

Id DIM Q% Idd 

20 FOR I = 0 TO 3 STEP 3 

30 P% = Q% 

40 [OPT I 
50 LDA &70 
60 CMP #0 
70 BEQ Zero 
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80 STA &72 
90 .Zero RTS 
100 ] 

110 NEXT 


On the first time through the loop, 1 = 0 and so there will be no listing and 
no error reported. This run allows the computer to identify the forward 
referenced label. The second time through the loop, 1=3 and hence a list 
of compiled code is produced, along with any programming errors. Note 
that the assignment statement P*/t — Q% is enclosed within the loop so 
that it is reset before each pass. 

On running this program, you will see a listing of the assembled machine- 
code alongside the Assembly Language mnemonics: 


>RUN 

0E75 

0E75 A5 70 
0E77 C9 00 
0E79 F0 02 
0E7B 85 72 
0E7D 60 


OPT l 
LDA &70 
CMP #0 
BEQ Zero 
STA &72 
.Zero RTS 


This means that the mnemonics have been successfully assembled, and 
the corresponding machine-code has been loaded into addresses &0E75 
to &0E 7D. &A5 is stored in location &0E 75, &70 in location &0E 76, &C9 
in location &0E77, and so on to 60 which is stored in location &0E7D. 
This is nine bytes of machine-code in all. 

This routine has not yet been executed. To do that a CALL from BASIC is 
required: 


CALL Q% 


RETURN 


Nothing is printed on the screen when you do this, and that’s because the 
program is trivial; it merely loads a byte from memory location &70 into 
the accumulator, and if it isn’t zero it is stored in memory location &72. 
There are some points to note about the structure of the Assembly 
Language routine: 
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- When a label is assigned to a line, as at line 90, it must be preceded by 
a full stop. When the label is called by an instruction, as at line 70, 
there must be no full stop. 

- Most Assembly Language routines end with RTS (return from sub¬ 
routine) which transfers control back to the BASIC interpreter. 

- The above routine uses two locations in the zero page of memory. 
Only locations &70 to &8F in the zero page may be used by your own 
programs; all the remainder is taken up by the operating system’s 
variables, and BASIC’s workspace. 

Execution by USR 

USR is similar to a BASIC FN (function); it gives a single value. 

The format is: 

R% = USR(Z) 

where Z may be a label pointing to the first assembler mnemonic, or the 
address of the first instruction in machine-code. A label is easier to use 
since it requires no knowledge of where the machine-code is placed in 
memory. When R% = USR(Z) is executed, the least significant byte of 
each of the BASIC integer variables A%, X%, and Y% is placed into the 
accumulator, X register, and Y register respectively. The least significant 
bit of C% is placed in the carry flag (bit C of the flags register). A%, X%, 
Y%, and C% can therefore be used to initialise the 6502 registers before 
entry into the assembler routine. Control then passes to the subroutine 
pointed to by Z. On returning to BASIC (after RTS), the four bytes 
comprising R% will each contain the contents of one of the 6502 registers, 
as follows: 

R% = PYXA 

So R% contains the flags, Y register, X register, and accumulator in that 
order. 

Any or each of these registers may be extracted from R% by setting up a 
mask using AND. To get the accumulator, the least significant byte is 
required: 

Acc = R% AND &FF 


Similarly for X, Y: 



X = (R% AND OFF00) DIV 0100 
Y = (R% AND OFF0000) DIV 010000 

To get the flags: 
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10 DIM BLOCK 3 
20 IBLOCK = USR(Z) 


Then (Acc = BLOCK70, X = BLOCK71, Y = BLOCK72), the flags = 

BLOCK73 

Here is a program which uses USR. The Assembly Language routine adds 
the numbers held in X% and A%, and gives the result in the accumulator: 

10 DIM Q% 100 

20 FOR I = 0 TO 3 STEP 3 

30 P% = Q% 

40 [OPT I 
50 .Start STA 080 
60 TXA 
70 CLC 
80 CLD 
90 ADC 080 
100 RTS 
110 ] 

120 NEXT 

130 INPUT "First number ”A% 

140 INPUT "Second number "X% 

150 RegistersS = USR(Start) 

160 Sum% = Registers*/! AND OFF 

170 PRINT "Sum of two numbers is ";Sum% 


When RUN, you will see the following: 


>RUN 


0F0A 

OPT 1 

0F0A 85 80 

.Start STA 080 

0F0C 8A 

TXA 

0F0D18 

CLC 

0F0E D8 

CLD 

0F0F 65 80 

ADC 080 

0F11 60 

RTS 

First number 

11 
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Second number 12 

Sum of two numbers is 23 

The numbers 11 and 12 are entered by the user, and are stored in the 
integer variables A% and X%. The USR call tells the computer to start 
executing the assembly routine from the label Start. Before this 
happens, the least significant byte of A 1 /# is placed in the accumulator, 
and the least significant byte of X% into the X register. The machine- 
code corresponding to the assembler mnemonics is now executed in 
sequence: 

STA 080 stores the contents of the accumulator in memory location &80. 

TXA transfers the contents of the X register to the accumulator. 

CLC clears the carry flag prior to addition. If this is not done then a 
spurious carry may be added to give an incorrect result. 

CLD clears the D flag so that the 6502 is working in binary mode. 

ADC &80 adds the contents of the accumulator to the contents of memory 
location &80, plus the contents of the carry flag; and places the result in 
the acccumulator. 

RTS returns control to BASIC. 

Back in the BASIC section, Registers'^ now contains the four 6502 
registers’ contents. The result is in the accumulator, so the least 
significant byte of Registers% is placed into Sum%, which is then printed 
to give the answer. Note that this routine performs only a single-byte 
addition, so any result given in Sum% will be MOD 256. 

Execution by CALL 

CALL is similar to a BASIC PROC (procedure). 

Here is another addition routine: 

10 DIM a% 100 

20 FOR 1=0 TO 3 STEP 3 

30 P% = Q% 

40 [DPT I 
50 .Start CLC 
60 CLD 
70 LDA &80 
80 ADC &81 
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9H STA &82 

100 RTS 
lid] 

120 NEXT 

130 INPUT "First number "number1% 

140 INPUT "Second number "number2% 

150 ?&80 = number1% 

160 ?&81 = number2% 

170 CALL Start 
180 Sum*/. = ?&82 

190 PRINT "Sum of two numbers is ”;Sum% 


This program illustrates the use of the indirection operator?. Indirection 
operators are very useful when calling assembly routines. 


Here is a list to refresh your memory: 


?&80 = J% 

!&80 = &12345678 

$V% = "FAULT' 


S% = ?&80 
R% = !&87 

R$ = $8-2000 


Will put the least significant byte of J% in 
location &80. 

Will put &78 in location &80, &56 in location 
&81, &34 in location &82, and &12 in location 
&83. 

Will put the string "FAULT' plus a carriage 
return (j Nl) in locations starting at V%. V% 
must not be in zero page. 

Will read the contents of location &80 (1 byte) 
into S%. 

Will read 4 bytes from locations &87 to &8A 
into R%; &8B being the most significant, &87 
the least significant. 

Will read a string starting at &2000 into R$. 


The addition program shown above has exactly the same effect as the 
previous example. In this instance though, the two numbers are stored 
into memory in the BASIC part of the program, and are added and the 
result stored in the Assembly Language part. 

CALL may also be used with parameters, similar to PROC. This takes the 
form: 


CALL Start.integer%,decimal,string% > ?byte 

The parameters are separated by commas. Start is a label, but could 
equally well be a specific address, &2000 for example. The above CALL 
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shows that any kind of variable may be passed as a parameter: integer, 
real, string, and single-byte. When a CALL is made, the parameters are 
assigned to a parameter block, which starts at memory location &600. 
The format of this parameter block is: 


Address Contents 


&600 

&601 

&602 

6603 

6604 

6605 

6606 


Number of parameters 
1st parameter address (low) 
1st parameter address (high) 
1st parameter type 
2nd parameter address (low) 
2nd parameter address (high) 
2nd parameter type 


There may be any number of parameters, and this number is given in the 
first byte of the parameter block. Following this, each parameter’s 
address and type is given. 

The type is designated by a number: 


0 

4 

5 

128 

129 


A single byte (eg ?location) 

A 4-byte variable (eg Z% or laddress) 

A 5-byte variable (eg number) 

A defined string (eg “YES PLEASE”) which must end 


RETURN 


with &D (| 

A string variable (eg name$) 


) 


The way that the parameter block is laid out, it would seem that the best 
way to access the individual parameters is to use indirect addressing. 
Unfortunately, the 6502 only allows the zero-page to be used for indirect 
address pointers, so here is a routine which transfers the addresses from 
the parameter block into free locations in the zero-page: 


LDA bm 
BEQ End 
STA &70 
LDX #(l 
LDY #0 

Loop LDA &601.Y 
STA &71,X 
INX 


\ Check the number of parameters. 
\ If zero then finish. 

\ If not then store this number. 

\ Clear the X register 
\ and the Y register. 

\Take high address of parameter. 
\and store it in zero-page. 

\ Increment X register. 
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-- 

INY 

\ and Y register. 


LDA 0601 r Y 

\ Take low address of parameter. 


STA 071.X 

\ and store it in zero-page. 

—. 

INX 

\ Increment X register 


INY 

\ and Y register 


INY 

\ twice. 

— 

DEC 070 

\ Decrement number of parameters. 


BNE Loop 

\ If still not zero then repeat. 


.End RTS 

\ Return to BASIC. 


This routine stores the address of each parameter in zero-page memory 
starting at location &71. 15 parameter addresses may be stored in this 
way before the total user zero-page memory is filled. This routine is very 
useful if the number of parameters passed to a particular Assembly 
Language subroutine is not always the same, for it will only relocate the 
addresses of those parameters which exist. 

Here this routine is incorporated into another addition program: 

10 DIM Q% 100 

20 FOR 1=0 TO 3 STEP 3 

30 P% = Q% 

40 [OPT I 

50 Start CLC 

60 CLD 

70 LDA 0600 

80 BEQ End 

90 STA 070 

100 LDX #0 

110 LDY #0 

120 .Loopl LDA 0601 r Y 

130 STA 07LX 

140 INX 

150 1NY 

160 LDA 0601.Y 
170 STA 071,X 
180 INX 
190 INY 
200 INY 
210 DEC 070 
220 BNE Loopl 
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230 End LDX #0 
240 STX him 
250 LDY B600 
260 BEQ Finish 
270 .Loop2 LDA (&71,X) 

280 ADC &2000 
290 STA B2000 
300 INX 
310 INX 
320 DEY 
330 BNE Loop2 
340 .Finish RTS 
350 ] 

360 NEXT 

370 INPUT"First number "one% 
380 INPUT"Second number "two% 
390 INPUT'Third number "three 0 /. 
400 CALL Start,one% 

410 Sum%= : ?&2000 
420 PRINT Sum - /. 

430 CALL Start,one%,two% 

440 Sum%=?&2000 
450 PRINT Sum 0 /. 

460 CALL Start,one%,two%,three% 
470 Sum%=?&2000 
480 PRINT Sum% 


The parameter block transfer routine ends at line 240, where the 
addition routine begins. Notice that the whole routine is CALLed with 
varying numbers of parameters, just to prove that it works. The result of 
adding the parameters is given in location &2000. However, as with the 
previous programs, the result is MOD 256. 


Quadruple precision addition 

Integer variables are stored in four consecutive bytes of memory. Groups 
of four bytes can be accessed using!, and can be added together. This is 
achieved a byte at a time, starting with the least significant, and storing 
each successive result: 


10 DIM Q% 100 
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20 FOR I = 0 TO 3 STEP 3 
30 P% = Q% 

40 [OPT 1 
50 .Start CLC 
60 CLD 
70 LDX #0 
80 LDY #4 
90 Loop LOA &70.X 
100 ADC &74,X 
110 STA &78,X 
120 INX 
130 DEY 
140 BNE Loop 
150 RTS 
160 ] 

170 NEXT 
180 INPUT "First number "one% 

190 INPUT "Second number "two% 

200 !&70 = one% 

210 !&74 = two% 

220 CALL Start 
230 sum% = !&78 

240 PRINT "Sum of two numbers is ";Sum% 

This program will work with positive or negative integers. 


\Clear carry for ADC instruction 

\ Clear X register 
\ Set Y register to 4 as a counter 
\ Put byte from one% in accumulator 
\ Add byte from two% 

\ Store result 
\ Increment X register 
\ Decrement Y register 
\ If not zero then repeat 


Multiplication 

The 6502 does not have a multiply instruction. Multiplication is 
achieved by adding and shifting, just like ordinary decimal long- 
multiplication. As a simple example, take the multiplication of two 4-bit 
numbers. Such a multiplication can give an 8-bit result: 

(i) Test the rightmost bit of the multiplier. If it is zero then add 0000 to 
the most significant end of the result. If it is 1 then add the number to be 
multiplied to the most significant end of the result. 

(ii) Shift the result one bit position to the right. Repeat (i) for the next bit 
of the multiplier. 

Applying the above to 1101*1001, the rightmost bit of the multiplier 
(1001) is 1. Therefore 1101 is added to the most significant end of the 
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result: 

1101 

Shift the result right one bit position: 

01101 

The next bit of the multiplier is zero, so 0000 is added to the result, and it 
is again shifted right: 

001101 

The next bit is again zero: 

0001101 


The final bit is 1, so 1101 is added to the result, and the final shift is 
performed: 

01110101 


Notice that for 4-bit multiplication, four shifts are required. 8-bit 
multiplication will require eight shifts, 16-bit multiplication 16 shifts, 
and so on. 

To put the above routine into practice on the 6502, the shift and rotate 
instructions are used. Here is a program to multiply two 8-bit numbers: 


10 DIM Q% 100 

20 FOR 1=0 TO 3 STEP 3 

30 PS = Q% 

40 [OPT I 
50 .Start CLD 
60 LDA #0 
70 STA &72 
80 STA &73 
90 LDY #8 
100 .Loop LSR &71 
110 BCC NoAdd 
120 CLC 


\ Clear 16-bits 
\ for the result. 

\ Set Y to 8 as a counter. 

\ Shift multiplier right one bit. 
\ Test this bit. Branch if zero. 
\ Clear carry prior to addition. 
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130 LDA 870 

140 ADC &73 
150 STA 873 
160 NoAdd ROR 873 
170 ROR 872 
180 DEY 
190 BNE Loop 
200 RTS 
210 ] 


\ Load accumulator with number to be 
\ multiplied. 

\ Add most significant byte of result. 

\ Store in most significant byte of result. 
\ Shift result right, with carry 
\from addition. 

\ Decrement counter. 

\ Repeat if not zero. 


220 NEXT 

230 INPUT "First number "one% 

240 INPUT "Second number "two% 

250 ?&70 = one 0 /. 

260 ?&71 = two% 

270 CALL Start 

280 Product 0 /. = ?&72 + 256*?&73 

290 PRINT "Product of two numbers is ";Product% 


This routine is not the most efficient way of multiplying two bytes 
together, but it illustrates the method clearly: 

Lines 60, 70 and 80 clear the two bytes in memory which will be used for 
the result of the multiplication. These locations are &7 2 (result low byte) 
and &73 (result high byte). 

Lines 250 and 260 store the numbers to be multiplied in locations &70 
and &71. It doesn’t matter which of these is chosen to be the multiplier; 
the example uses the number in &71. 

Line 90 sets the Y register to 8 as a counter. Because this is an 8-bit 
multiplication, eight shifts are required. 

Line 100 shifts the multiplier right one bit position. The rightmost bit 
falls into the carry where it can be tested. 

Line 110 carries out the test. If the C bit is zero then the program 
branches to N oAdd; if it is 1 then the addition of the number in &70 to the 
result high byte (&73) takes place. 

Lines 120 to 150 accomplish this addition, by clearing the carry bit, 
loading the accumulator from &70, adding the result high byte, and then 
storing back in the result high byte. 

Line 160, labelled NoAdd, rotates the result high byte right one bit 
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position. The carry from the addition in line 140 is entered from the left, 
and the rightmost bit falls into the carry. 

Line 170 rotates the result low byte right one bit position. The leftmost 
bit from the high byte, now in the carry, enters the low byte from the left. 

Line 190 decrements the counter, and repeats the above process until 
the counter is zero. 

The program will give the result of multiplying two positive integers, 
each between 0 and 255. You can see how many instructions it takes just 
to do this, and can imagine the complexity of a BASIC statement when it 
is interpreted into machine-code. 

A shorter routine to multiply two bytes uses the accumulator as the 
result high byte, and the multiplier as the result low byte. As each bit of 
the multiplier is shifted into the carry to be tested, the leftmost bit of the 
multiplier location becomes vacant, so allowing the result to be shifted 
in. 


.Start 


.Loop 


.NoAdd 


CLD 


LDA #0 

\ Clear result high byte. 

LDY #8 

\ Set shift counter. 

ROR &71 

\ Shift multiplier right one bit. 

BCC NoAdd 

\ Test this bit. Branch if zero. 

CLC 

\ Clear carry prior to addition. 

ADC &70 

\ Add number to be multiplied. 

ROR A 

\ Shift result right, with carry from addition. 

DEY 

\ Decrement counter. 

BNE Loop 

\ Repeat if not zero. 

ROR &71 

\ Final shift of result. 

STA &72 

RTS 

\ Store result high byte. 


Before using this routine, the two bytes to be multiplied are placed in 
locations &70 and &71. The result appears in &71 (low byte) and &72 
(high byte). 

To multiply two 4-byte numbers together, the additions and shifts must 
act on each byte in turn, and the total number of shifts must be 32. 


.Start 


CLD 

LDX #8 
LDA #0 


\ Clear 
\ eight 
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.Clear 


.Loop 


.NoAdd 

.Shift 


STA &77,X 

\ hytes 

DEX 

\ for 

BNE Clear 

\ result. 

LDY #32 

\ Set shift counter. 

LSR &77 

\ Shift four hytes 

ROR &76 

\ of multiplier 

ROR &75 

\ right 

ROR &74 

\ one bit. 

BCC NoAdd 

\ Test this bit. Branch if zero. 

CLC 

\ Clear carry prior to addition. 

LDA &7JJ 

\ Add 

ADC &7C 

\ 4-byte 

STA &7C 

\ multiplier 

LDA &71 

\to 

ADC &7D 

\ 4-byte 

STA &7D 

\ result 

LDA &72 

\ and 

ADC &7E 

\ store. 

STA &7E 

\" 

LDA &73 

\" 

ADC &7F 

\" 

STA &7F 

\" 

LDX #8 

\ Shift 

ROR &77.X 

\ eight bytes 

DEX 

\of result 

BNE Shift 

\ right 

DEY 

None bit. 

BNE Loop 
RTS 

\ Repeat if not zero 


Before using this routine, the two numbers to be multiplied must be 
placed in !&70 and !&74. The result appears in the four bytes from &78 
(least significant) to &7B (most significant), and is accessed as !&78. This 
routine will work with both positive and negative integers. 


Division 

Division is accomplished as the reverse of multiplication. 8-bit 
multiplication gave a 16-bit result, so, for division, a 16-bit numerator 
and 8-bit denominator will give an 8-bit result. The numerator is stored 
in two bytes of memory. It is shifted left one bit position and the 



226 Assembly Language 


numerator high byte is then loaded into the accumulator. If the shift 
produced a carry then a 1 is shifted left into the result, the denominator is 
subtracted from the accumulator, and the accumulator contents are then 
stored in the numerator high byte. If the shift did not produce a carry 
then the denominator is subtracted from the accumulator in any case. If 
this subtraction produces a carry then a 1 is shifted left into the result 
and the accumulator contents are stored in the numerator high byte. If no 
carry, then 0 is shifted left into the result. 

This whole process is repeated eight times. The division program is as 
follows: 


10 DIM Q% 100 
20 FOR I—0 TO 3 STEP 3 
30 P% = Q% 

40 [OPT I 


50 .Start CLD 
60 LDY #8 
70 .Loop ASL &72 
80 ROL 873 
90 LDA 873 
100 BCC Label 
110 SBC 871 
120 STA 873 
130 SEC 
140 JMP Shift 
150 .Label SEC 
160 SBC 871 
170 BCC Shift 
180 STA 873 
190 .Shift ROL 870 
200 DEY 
210 BNE Loop 
220 RTS 
230 ] 

240 NEXT 

250 INPUT "Numerator 


\Set shift counter. 

\ Shift numerator 
\ left one bit. 

\ Load accumulator high byte. 

\Test carry produced by shift. 

\ Subtract denominator and 
\ store in numerator high byte. 

\ Set carry prior to shifting into result. 
\ Go to Shift. 

\ Set carry prior to subtraction. 

\ Subtract denominator 
\ and test carry. 

\ Store in numerator high byte. 

\ Shift either 0 or 1 into result. 

\ Decrement counter. 

\ Repeat if not zero. 


'numerator% 


260 INPUT "Denominator "denominator*/* 
270 P% = &71 
280 [OPT 3 


290 EQUB denominators \ Store denominator at location 871 
300 E0.UW numerator 0 /* \ Store numerator at locations 872 and 873 
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310 RTS 

320 ] 

330 CALL Start 

340 PRINT 'Quotient is ";?&70 
350 PRINT 'Remainder is ";?fr73 

In this routine, the denominator is stored at location &71, and the 
numerator in two bytes &72 and &73. The result appears in &7 0, and any 
remainder is left in &73. Remember, this is a 16-bit by 8-bit division, so 
the denominator may not be greater than 255 and the numerator not 
greater than 65025 (255 2 ) to give a valid result (the result must be 255 or 
less). 

The short routine from lines 280 to 320 is used to store the data in 
memory, and contains some instructions which you have not yet seen or 
used. EQUB and EQUW are in the same class of instruction as OPT, in that 
they are used in the Assembly Language part of the program but are not 
assembly instructions. They are used simply to store data at the 
location(s) at which they appear when assembled into machine-code. 
You will see this clearly when you RUN the above program. After you 
have typed in the numerator and denominator you will see a listing of the 
machine-code from &0071 to &0074. 

There are in fact four EQU instructions: 

EQUB stores a byte of data. 

EQUW stores a word of data (2 bytes). 

EQUD stores a double-word of data (4 bytes). 

EQUS stores the ASCII representation of a string. 

EQUS is illustrated in the next section on error handling in Assembly 
Language. 

Notice in the program example above how putting P% equal to &71 
enables the denominator to be stored in &71 using EQUB, and the 
numerator to be stored in &72 and &73 using EQUW. EQUD may be used 
to store the contents of a full BASIC integer variable. (You may use EQUB 
instead of ?, and EQUD instead of !.) 

Error trapping in assembler 

The assembler will tell you of any mistakes which you make in typing in 
programs (syntax errors), and some errors associated with BASIC 
variables during assembly, but there is no such thing as a run-time error 
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in machine-code: you just have to fathom it out line by line. However, it is 
possible for you to trap errors generated while a machine-code program 
is running by using the BRK instruction. As an example, take the division 
program described in the previous section. Everyone knows that it is not 
possible to divide by zero, but the program does not know this. If you try 
to do so it unwittingly gives the answer 255. 

It is simple to test the denominator before the division is started, and 
then to branch to an error routine. The whole program is not repeated 
here, but the following lines may be added: 

53 LDA &71 
56 BEQ Error 

222 .Error BRK 
224 EQUB 18 

226 EQUS "Division by zero" 

228 BRK 

If you now run the program with a zero denominator, it will stop and print 
the message: 

Division by zero at line 33|l 

You can also type 

PRINT ERR 

upon which it will give the correct error number, 18. 

Any error message must take the following form: 

BRK 

EQUB errornumber (ERR) 

EQUS "message" 

BRK 

Operating system calls from assembler 

All the operating system calls available from BASIC, and many more, are 
available from a machine-code program. These routines are always 
accessed using a JSR to some address in the operating system, and 
usually involve the passing of one or more parameters via the 
accumulator (for 1), X and Y (for 2 or 3), or a parameter block in memory 
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(for more than 3). 

Here is a table showing all the operating system calls available. 


Routine 

Name Address 

Vector 

Name Address 

Summary of function 



UPTV 

EVNTV 

FSCV 

222 

220 

21E 

User print routine 
Event interrupt 

File system control 
entry 

OSFIND 

FFCE 

FINDV 

21C 

Open or close a file 

OSBPUT 

FFD4 

BPUTV 

218 

Save a single byte to 
file from A 

OSBGET 

FFD7 

BGETV 

216 

Load a single byte to 
A from file 

OSARGS 

FFDA 

ARGSV 

214 

Load or save data 
about a file 

OSFILE 

FFDD 

FILEV 

212 

Load or save a 
complete file 

OSRDCH 

FFEO 

RDCHV 

210 

Read character (from 
keyboard) to A 

OSASCI 

FFE3 


i 

Write a character (to 
screen) from A plus 
LF if (A)=&0D 

OSNEWL 

FFE7 

— 

— 

Write LF,CR (&0A, 
&0D) to screen 

OSWRCH 

FFEE 

WRCHV 

20E 

Write character (to 
screen) from A 

OSWORD 

FFFl 

WORDV 

20C 

Perform miscellaneous 
OS operation using 
control block to pass 
parameters 

OSBYTE 

FFF4 

BYTEV 

20A 

Perform miscellaneous 
OS operation using 
registers to pass 
parameters 

OSCLI 

FFF7 

CLIV 

208 

Interpret the 
command line given 
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When you use one of these routines, you must use a JSR to the 
corresponding address shown in the second column. For example, 
OSWRCH is called from assembler by typing: 

JSR &FFEE 

The routine stored at &FFEE uses the OSWRCH vector address, shown in 
the fourth column, as an indirect pointer to the actual location of the 
OSWRCH routine. 

The reason for this is twofold: 

(i) The actual address of the OSWRCH routine may be altered by the 
manufacturer without affecting the operating system subroutine call in 
any way. JSR &FFEE will always give an OSWRCH call even though the 
address held in locations &20E and &20F may not be the same on every 
machine. 

(ii) The user can alter the address held in the zero-page vector location 
and trap any call of that particular operating system routine, indirecting 
such a call to the user’s own routine anywhere in memory. 

Use of operating system calls 

OSWRCH entry: &FFEE vector: &20E 

This call writes the character whose ASCII code is in the accumulator to 
the screen. 

Here is an example which will print the character L on the screen: 

10 p% = &7ji 

20 [OPT 3 

30 .Start LDA #76 \ Load accumulator with ASCII code for L 

40 JSR &FFEE \ Jump to.OSWRCH 

50 RTS 
60] 

70 CALL Start 

OSWRCH is also used with ASCII control codes (from 0 to 31). If you 
change line 30 to: 


30 .Start LDA #7 
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then the program will output ASCII character 7, which is a ‘beep’. 

Some BASIC instructions have ASCII values in the control code range, 
and these can therefore be used with OSWRCH. For example, PLOT has 
an ASCII value of 25, TAB an ASCII value of 31. 

The following program uses TAB to print the character L half way across 
the screen: 

10 P% = &70 
20 [OPT 2 
30 .Start LDA #31 
40 JSR &FFEE 
50 LDA #19 
60 JSR &FFEE 
70 LDA #VP0S 
80 JSR EfFFEE 
90 LDA #76 
100 JSR CrFFEE 
110 RTS 
120 ] 

130 CALL Start 

Each parameter is passed in turn to OSWRCH via the accumulator. The 
BASIC statement equivalent to the above program is: 

PRINT TAB(19);"L"; 

(Note that this program will not work with OPT 3 because VPOS is 
affected.) 

The BASIC instruction PLOT takes three parameters, PLOT A,X,Y. 
However, X may be 0 to 1279 and Y may be 0 to 1023, so each must be 
represented by two bytes. That means that an OSWRCH call with the 
accumulator set to 25 must be followed by five more OSWRCH calls to 
pass the parameters. The following program will plot a line on the screen: 

10 MODE 4 
20 P% = &70 
30 [OPT 3 
40 Start LDA #25 
50 JSR &FFEE 
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60 LDA #5 
70 JSR &FFEE 
80 LDA #88 
90 JSR &FFEE 
100 LDA #2 
110 JSR &FFEE 
120 LDA #44 
130 JSR 8-FFEE 
140 LDA #1 
150 JSR &FFEE 
160 RTS 
170] 

180 CALL Start 

This program is equivalent to 

PLOT5,600,300 

Lines 100 and 80 give X (2*256 + 88) and lines 140 and 120 give Y 
(1*256 + 44). 

You’ll see from the listing that the above routine, when assembled, 
occupies memory from &70 to &8E. Remember that user programs must 
use zero-page locations only between &70 and &8F, so this is almost the 
largest size routine that may be stored in the zero-page. 

OSASCI entry: &FFE3 

Writes the character whose code is in the accumulator to the screen using 
OSWRCH. However, if the accumulator contains &D then OSNEWL is 
called instead. The actual code at location &FFE3 is: 

OSASCI CMP #&D 

BNE OSWRCH 
.OSNEWL LDA #&A 

JSR OSWRCH 
LDA #&D 

.OSWRCH JMP (WRCHV) 

OSNEWL entry: &FFE7 

This call issues a line feed/carriage return to the screen, as shown above. 
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After using OSWRCH, OSASCI, or OSNEWL, the contents of the 
accumulator, X, and Y registers are unchanged. Flags C, N, V, and Z are 
undefined, and D = 0. 

OSRDCH entry: &FFE0 vector: &210 

This call reads a character code from the keyboard into the accumulator. 

After using OSRDCH, the contents of the X and Y registers are 
unchanged. Flags N, V, and Z are undefined, and D = 0. Flag C tells 
whether the read has been successful (C = 0). If C = 1 then an error has 
occurred and the error number is given in the accumulator. If C = 1 and A 
= &1B then an escape condition has been detected and you must 
acknowledge this by performing an OSBYTE call with A = &7E, or 
*FX126. 


OSCLI entry: &FFF7 vector: &20B 

This call is used by the BASIC OSCLI instruction. From assembler it 
consists of a JSR to &FFF7, the command line string being placed in 
memory at a location given by the contents of the X register (address low 
byte) and Y register (address high byte). The command line string must 


RETURN 


be terminated by &D _ 

The following BASIC program illustrates this: 


10 DIM address 20 
20 keynumber = 4 

30 $address = "KEY"+STR$ keynumber+"LI$T i M" 
40 X% = address MOD 256 
50 Y% = address DIV 256 
60 CALL &FFF7 


This will have the same effect as 

*KEY4"LIST IM" 


RETURN 


Note: The string indirection operator $ automatically puts a 
code (&D) after the string. EQUS however does not, and it must be 
inserted afterwards using EQUB &D or something like EQUS "FRED" ~\~ 
CHR$13. 
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OSFIND entry: &FFCE vector: &21C 

Opens a file from cassette or disc for reading or writing. The contents of 
the accumulator determine the operation performed: 

A = 0 closes a file or files (CLOSE#). 

A = &40 opens a file for input (OPENIN). 

A = 080 opens a file for output (OPENOUT). 

A = BC0 opens a file for input or output (OPENUP). 

When OPENIN, OPENOUT, or OPENUP is used, X and Y must contain the 
address of the filename. After the subroutine call, the accumulator will 
contain the channel number allocated to that file by the operating 
system. 

If CLOSE# is used then Y must contain the channel number of the file to 
be closed. If Y is 0 then all files will be closed. 

OSBPUT entry: &FFD4 vector: &218 

Writes the byte contained in the accumulator to the cassette or disc file 
(same as BPUT#). Y must contain the file channel number. After using 
OSBPUT, the contents of the accumulator, X, and Y registers are 
unchanged. 

OSBGET entry: &FFD7 vector: &216 

Heads a byte from the cassette or disc file into the accumulator (same as 
BGET#). Y must contain the file channel number. After using OSBGET, 
the contents of the X and Y registers are unchanged. Flags N, V, and Z 
are undefined, and D = 0. Flag C tells whether the read has been 
successful (0 = 0). If C = 1 then an error has occurred and the error 
number is given in the accumulator. If C = 1 and A = &FE then the end of 
file has been reached. 

OSFILE entry: &FFDD vector: &212 

Allows a whole file to be loaded or saved. The contents of the 
accumulator indicate the function to be performed. X and Y point to an 
18 byte control block anywhere in memory, the structure of which is as 
follows: 

OSFILE control block 

00 

01 


Address of file name, which must be terminated 
by &0D 


LSB 

MSB 
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02 

03 

04 

05 

Load address of file 

LSB 

MSB 

06 

Execution address of file 

LSB 

07 



08 



09 


MSB 

0A 

Start address of data for write operations, 

LSB 

0B 

or length of file for read operations 


0C 



0D 


MSB 

0E 

End address of data, that is byte after 

LSB 

0F 

last byte to be written or file attributes 


10 



11 


MSB 


The table below indicates the function performed by OSFILE for each 
value of A. 


A=0 Save a section of memory as a named file. The file’s catalogue 

information is also written. 

A=1 Write the catalogue information for the named file. 

A=2 Write the load address (only) for the named file. 

A=3 Write the execution address (only) for the named file. 

A=4 Write the attributes (only) for the named file. 

A=5 Read the named file’s catalogue information. Place the file 
type in A. 

A—6 Delete the named file. 

A=&FF Load the named file and read the named file’s catalogue 
information. 

Note: Values 1 to 6 are not available on a cassette filing system. 


OSBYTE entry: &FFF4 vector: &20A 

This is a family of operating system calls which includes all the *FX calls 
available from BASIC. (These are not repeated here.) The call number is 
passed in the accumulator and parameters are passed in X or Y or both. 
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All OSBYTE calls are available from BASIC via a USR call, or by using a 
*FX call. 

Here is a list of functions as given by each accumulator value (A): 

A= 127 (EOF#) *FX127 

Gives the end of file status of a previously opened file. X must contain the 
file channel number. Afterwards, X will be zero if the end of file has not 
been reached, non-zero if the end of file has been reached. 


A =129 (INKEY) *FX129 

Either waits for a character from the keyboard buffer until a time limit 
expires (INKEYpositive) or tests if a key is depressed (INKEYnegative). 
All the discussion about auto-repeat and buffer flushing applies to this 
call. 


For IN KEYpositive, Y must contain the most significant byte of the delay, 
and X the least significant (in hundredths of a second). 


Afterwards, if Y = 0 then a character has been detected and its code 


ESCAPE 


was pressed and must be 


appears in X. Y = &1B indicates that_ 

acknowledged with *FX126. Y = &FF indicates that no key was pressed 
in the allocated time. 


For INKEYnegative, Y must contain the requisite key-code in twos 
complement. Afterwards Y will be either TRUE (&FF) or FALSE (zero) 
depending on whether the key was pressed. 


A = 131 (OSHWM) *FX131 

Gives the address of the first free location in memory above that required 
for the operating system. Usually equal to &E00. The address is given in 
X (low byte) and Y (high byte). For example, after *FX20,6. 


A =132 *FX132 

Gives the lowest memory address used by the screen display in X (low 
byte) and Y (high byte). 

A = 133 Low mode address *FX133 

Gives the lowest address in memory used by a particular mode. Does not 
change mode but merely investigates the consequences of doing so. The 
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mode to be investigated must be in X. Afterwards, the address is 
contained in X (low byte) and Y (high byte). 

A = 134 Read position of text cursor *FX134 

Gives in X the X coordinate of the text cursor, and in Y the Y coordinate 
(same as POS and VPOS). 

A = 135 Read character at position of text cursor *FX135 

Gives in X the ASCII code of the character at the current text cursor 
position, and in Y the current mode number. X is 0 if the character is not 
recognisable. 

Here is a BASIC function which can be used to read the character at any 
position X,Y on the screen: 

1000 DEF FNreadcharacter(columnVo,row%) 

1100 LOCAL A%,currentX%,currentY%,character% 

1200 currentX% = POS: currentY% = VPOS 
1300 VDU31,column%,row% 

1400 A% = 135 

1500 character = (USR(&FFF4) AND &FF00) DIV &100 
1700 VDU31,currentX%,currentY% 

1800 = CHR$ character% 

To give the character at position X,Y this function would be called by 
passing X and Y as the two parameters: 

PRINT FNreadcharacter(X,Y) 

A = 137 Motor control *FX137 

Similar to *M0T0R. X = 0 will turn off the cassette motor, X = 1 will turn 
it on. 

A = 139 (*0PT) *FX138 

Exactly the same as *0PT. The parameters are passed in X and Y. 
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A = 145 Get character from keyboard buffer *FX145 

Reads a character code from a buffer into the Y register. X = buffer 
number (0 to 9 inclusive). C = 0 indicates a successful read, C = 1 
indicates that the buffer is empty. 

A = 218 Cancel VDU queue *FX218 

Many VDU codes expect a sequence of bytes (as shown earlier with PLOT 
and TAB). This call signals the VDU software to throw away the bytes it 
has received so far. Before use, X and Y must contain zero. 

OSWORD entry: &FFF1 vector: &20C 

This is a family of operating system calls which uses a parameter block 
somewhere in memory to supply data to the routine and to receive results 
from it. The exact location of the parameter block must be specified in X 
(low byte) and Y (high byte). The accumulator contents determine the 
action of the OSWORD call. 

A = 0 Read a line from keyboard to memory 

Accepts characters from the keyboardandplaces them at a specified 
location in memory. During inp ut the key (ASCII 127) deletes 

the last character entered, and U (ASCII 21) deletes the entire 

line. The routine ends if rTTPTn is entered (ASCII 13) or the [2E23 
key is pressed. 

The control block contains five bytes: 

YX (low byte) Address at which 
YX+1 (high byte) line is to be stored 
YX+2 Maximum length of line 
YX+3 Minimum acceptable ASCII value 
YX+4 Maximum acceptable ASCII value 

Characters will only be entered if they are in the range specified by 
YX+3 and YX+4. 

Afterwards, C = 0 indicates that the line was terminated by a . 

C not eq ual to zero indicates that the line was terminated by an 
I2H21- Y is set to the length of the line, excluding the carriage return if 
C = 0. 
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A — 1 Read clock 

Reads the internal elapsed-time clock into the five bytes pointed to by X 
and Y. The clock is incremented every hundredth of a second, and is used 
by the BASIC variable TIME. 

A = 2 Write clock 

Sets the internal elapsed-time clock to the value given in the five bytes 
pointed to by X and Y. Location YX is the least significant byte of the 
clock, YX4-4 is the most significant. 

A = 3 Read interval timer 

In addition to the clock there is an interval timer which is also 
incremented every hundredth of a second. The interval is stored in five 
bytes pointed to by X and Y. See OSWORD with A = 1. 

A = 4 Write interval timer 

X and Y point to five bytes which contain the new value to which the 
clock is to be set. The interval timer may cause an event when it reaches 
zero. Thus setting the timer to &FFFFFFFFFD would cause an event 
after three hundredths of a second. 

A = 7 SOUND 

Equivalent to the BASIC SOUND statement. The eight bytes pointed to 
by X and Y contain the four two-byte parameters (in fact only the least 
significant byte of each need be used). 


YX 

Q (channel, 0 to 3) 

YX+1 

zero 

YX+2 

A (envelope, -15 to 4) 

YX+3 

zero, or &FF if -1 or some other negative value 

YX+4 

P (pitch, 0 to 255) 

YX+5 

zero 

YX+6 

D (duration, 1 to 255) 

YX+7 

zero 


A = 8 ENVELOPE 

Equivalent to the BASIC ENVELOPE statement. X and Y point to 14 
bytes of data which are the 14 parameters used by ENVELOPE. 
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A = 9 POINT 

Equivalent to BASIC POINT function. The parameter block pointed to 
by X and Y must be set up as follows: 

YX X (low byte) coordinate 
YX+1 X (high byte) coordinate 
YX+2 Y (low byte) coordinate 
YX+3 Y (high byte) coordinate 

Afterwards, YX+4 will contain the logical colour value of that particular 
graphics coordinate. If the coordinate is off the screen then YX+4 
contains &FF. 

A = 10 Read character definition 

Characters are displayed on the screen as an 8X8 matrix of dots. The 
pattern of dots for each character, including user-defined characters, is 
stored as eight bytes. This call enables the eight bytes to be read into a 
block of memory starting at the address given in X and Y, plus 1. The 
ASCII code of the character must be the first entry on the parameter 
block when the routine is called. 

Afterwards, the parameter block contains data as shown below: 

YX Character code 

YX+1 Top row of displayed character 

YX+2 Second row of displayed character 


YX+8 Bottom row of displayed character 

Here is a program to illustrate this OSWORD call, and the method of 
calling OSWORDs in general. It takes each of the characters in turn, 
reads the matrix definition, and then reverses this definition by shifting 
the bits in each byte, and then redefining each character using VDU23. 
The result makes your program interesting to read, to say the least! 

10 MODE 6 
20 DIM Q% 100 
30 FOR 1=0 TO 3 STEP 3 
40 P% = Q% 

50 [OPT I 

60 .Character LDA 0601 \ Take low address of parameter 
70 STA &70 \ and store it in zero-page. 
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80 LDA 8-602 
90 STA 871 
100 LDY #0 
110 LDA (870),Y 
120 STA 870 
130 LDX #870 

140 LDA #10 
150 JSR 8FFF1 
160 LDX #0 
170 .Reverse LDY #8 
180 .Loop ASL 871,X 
190 ROR 870.X 
200 DEY 
210 BNE Loop 
220 INX 
230 CPX #8 
240 BNE Reverse 
250 RTS 
260 ] 

270 NEXT 
280 *FX20,6 
290 FOR l%—33 TO 126 
300 PRINT CHR$ 1%; 

310 CALL Character, 1% 

320 VDU23.I %,?&77,?&76,?&75 1 ?&74 l ?&73,?&72,?&71 ,?&70 
330 NEXT 

This program illustrates a number of the features demonstrated in this 
part of the book. It calls the machine-code routine Character with a para¬ 
meter, and lines 60 to 120 transfer the parameter to location &70, which 
is a safe place at which to store any 0 SWORD data. 

Line 130 sets X to the low byte of the address of the OSWORD 
parameter block (it is not necessary to set Y because Y is already zero). 

Lines 140 and 150 carry out the OSWORD call. 

Lines 160 to 240 reverse each of the bytes of the character definition. 

Line 280 explodes the character memory allocation to its maximum, 
allowing all the characters to be redefined, and line 320 carries out this 
redefinition. 


\ Take high address of parameter 
\ and store it in zero-page. 

\ Clear Y register. 

\ Get parameter (ASCII code) 

\ and store it in zero-page. 

\ Set X to OSWORD parameter block address low 
\ byte. 

\ Set OSWORD function. 

\ Jump to OSWORD. 

\ Clear X register. 

\ Set Y to 8 as shift counter. 

\ Shift each byte into the byte 
\ below, thereby reversing it. 

\ Decrement Y. 

\ Repeat if not zero. 

\ Increment X. 

\ Compare with 8. 

\ Repeat if not equal. 
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It should be noted that if this program were more than &300 bytes long, it 
would get overwritten by the soft characters. 

A — 11 Read colour assigned to logical value 

Gives the actual colour value assigned to the logical colour value 
contained in the location pointed to by X and Y. Afterwards, location YX 
will contain the logical value, and location YX+1 will contain the actual 
value. In fact YX+1 to YX+4 contain the four-byte physical colour-you 
must reserve space for five bytes. 


Events 


Events are conditions which occur within the computer and which can be 
trapped by the user so as to provide useful information, For example, it is 


possible to detect when the keyboard buffer is full, or when | 
been pressed. 


ESCAPE 


has 


To be able to act upon an event, that event must first be enabled by 

*FX14: 


*FX14,( enables output buffer empty event. 

*FX14,1 enables input buffer full event. 

*FX14.2 enables character entering keyboard buffer event, 

*FX14,4 enables start of vertical synchronisation of screen display event. 
*FX14,5 enables the interval timer crossing zero event. 


*FX14,6 enables 


ESCAPE 


pressed event. 


The operating system detects all the above events when they occur, but 
ignores them if they have not been enabled with the appropriate *FX14 
call. If an event occurs which has been enabled then program execution 
indirects via &220 and places an event code (shown below) in the 
accumulator. The contents of X and Y may also depend upon the event. 

The event codes are as follows: 


A = 0 
A = 1 

A = 2 
A = 3 
A = 5 
A = 6 


Output buffer empty. (X contains buffer identity.) 

Input buffer full. (X contains buffer identity, Y contains the 
ASOT code of character that could not be stored in buffer.) 
Key pressed. 

Vertical synchronisation of screen display. 

Interval t imer crossing zero, 
detected. 


ESCAPE 
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Any address may be stored in the two bytes &220 and &221 to which the 
program will transfer execution on detection of an enabled event. You 
may write your own code at this address in order to process the event, but 
it must be terminated by RTS, and should not take too long (one 
millisecond maximum). 

Each of the events may be disabled by a corresponding *FX13. For 
example, *FX13,1 will disable the input buffer full event. 


Assembly Language mnemonics 

This section describes, in alphabetical order, all the 6502 assembler 
mnemonics. 

The following abbreviations are used: 


A 

X 

Y 

F 

PC 

PCH 

PCL 

SP 

M 


0 

& 

(A4) 1 
(M7) >etc 
(X0)j 


accumulator 

index register X 

index register Y 

flags register 

program counter 

program counter (high byte) 

program counter (low byte) 

stack pointer 

memory address 

‘becomes’ (assignment) 

‘affects’ (flags) 
contents of 
hexadecimal 

specified bit position in register or memory 




V 

B 

D 

I 

Z 

c. 


status flags 


Because this section has been written for use with the Electron’s 
assembler, the addressing modes quoted are simplified as compared 
with those that are specified for use with general machine-code program¬ 
ming of the 6502. 
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ADC 

Action 

Description 

Addressing modes 


Flags affected 
Comments 

AND 

Action 

Description 

Addressing modes 


Flags affected 
Comments 

ASL 


Add with carry 


A-* - (A)+data+C 

Add the contents of memory location or im¬ 
mediate data to the accumulator, plus the carry 
bit. Result is placed in the accumulator. 

Immediate 

Zero-page 

Absolute 

Indexed 

Indirect/indexed 

NVZC 

To add without the carry, bit C must be cleared 
beforehand by using CLC. 


Logical AND 


A — (A) AND data 

AND the contents of memoiy location or im¬ 
mediate data with the accumulator. Result is 
placed in the accumulator. 

Immediate 

Zero-page 

Absolute 

Indexed 

Indirect/indexed 

NZ 

See BASIC AND for truth table. 


Arithmetic shift left 


Action 


C ■*- A or M •*- 0 
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Description 


Addressing modes 

Flags affected 
Comments 

BCC 

Action 

Description 

Addressing modes 
Flags affected 
Comments 

BCS 

Action 

Description 

Addressing modes 
Flags affected 
Comments 


Shift the contents of the accumulator or memory 
location left one bit position. Bit 7 falls into the 
carry (bit C), zero is entered from the right. Result 
remains in either the accumulator or the memory 
location. 

Zero-page 
Absolute 
Indexed (X only) 

Accumulator 

NZC 

ASL A acts on the accumulator. 


Branch if carry clear 

Go to specified label or address if C — 0 

If bit C is zero, execution continues at the spec¬ 
ified label or address. If bit C is 1 then execution 
continues at the next instruction. 

Relative 

None 

Specified label or address must be in range. 


Branch if carry set 

Go to specified label or address if C = 1 

If bit C is 1, execution continues at the specified 
label or address. If bit C is zero then execution 
continues at the next instruction. 

Relative 

None 

Specified label or address must be in range. 
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BEQ 

Action 

Description 

Addressing modes 
Flags affected 
Comments 

BIT 

Action 

Description 

Addressing modes 
Flags affected 

BMI 

Action 

Description 


Branch if equal to zero 

Go to specified label or address if Z = 1 

If bit Z is 1, execution continues at the specified 
label or address. If bit Z is zero then execution 
continues at the next instruction. 

Relative 

None 

Specified label or address must be in range. 


Compare memory bits with accumulator 


(A) p 

(M) 

The accumulator is compared with the contents of 
a memory location. If the two are the same then bit 
Z is set to 1; if not then bit Z is cleared. Bits 6 and 7 
of the data from memory are loaded into bits V and 
N respectively. The contents of the accumulator 
remain unchanged. 

Absolute 

Zero-page 

NVZ 


Branch if minus 

Go to specified label or address if N = 1 

If bit N is 1, execution continues at the specified 
label or address. If bit N is zero then execution 
continues at the next instruction. 


Addressing modes 


Relative 
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Flags affected 
Comments 

BNE 

Action 

Description 

Addressing modes 
Flags affected 
Comments 

BPL 

Action 

Description 

Addressing modes 
Flags affected 
Comments 

BRK 

Action 


None 

Specified label or address must be in range. 


Branch if not equal to zero 

Go to specified label or address if Z = 0 

If bit Z is zero, execution continues at the specified 
label or address. If bit Z is 1 then execution 
continues at the next instruction. 

Relative 

None 

Specified label or address must be in range. 


Branch if plus 

Go to specified label or address if N = 0 

If bit N is zero, execution continues at the speci¬ 
fied label or address. If bit N is 1 then execution 
continues at the next instruction. 

Relative 

None 

Specified label or address must be in range. 


Break 


STACK — (PC)+2 
STACK — (F) 

PCL — (&FFFE) 
PCH — (&FFFF) 
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Description 


Addressing modes 
Flags affected 
Comments 

BVC 

Action 

Description 

Addressing modes 
Flags affected 
Comments 

BVS 

Action 

Description 

Addressing modes 
Flags affected 
Comments 


This is a software interrupt. The contents of the 
program counter plus 2 are pushed on the stack, 
followed by the contents of the flags register. The 
program counter is then loaded with the contents 
of locations &FFFE (low byte) and &FFFF (high 
byte). Bit B is set to 1. 

Implied 

B 

Used mainly for error trapping and debugging. 


Branch if overflow clear 

Go to specified label or address if V = 0 

If bit V is zero, execution continues at the specified 
label or address. If bit V is 1 then execution 
continues at the next instruction. 

Relative 

None 

Specified label or address must be in range. 


Branch if overflow set 

Go to specified label or address if V = 1 

If bit V is 1, execution continues at the specified 
label or address. If bit V is zero then execution 
continues at the next instruction. 

Relative 

None 

Specified label or address must be in range. 
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CLC 

Action 
Description 
Addressing modes 
Flags affected 
Comments 

CLD 

Action 

Description 

Addressing modes 
Flags affected 
Comments 

CLI 

Action 
Description 
Addressing modes 
Flags affected 
Comments 


Clear carry 


C-0 

Bit C is cleared. 

Implied 

C 

Often required before ADC. 


Clear decimal flag 


D—0 

Bit D is cleared, which means that the processor is 
in binary mode. 

Implied 

D 

Should be used at the beginning of all routines 
which do not use binary coded decimal. 


Clear interrupt mask 


1 — 0 

Bit I is cleared, which enables interrupts. 

Implied 

I 

An interrupt is triggered when an external device, 
such as a printer, requires attention. 
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CLV 


Clear overflow flag 


Action 
Description 
Addressing modes 
Flags affected 


V— 0 

Bit V is cleared. 

Implied 

V 


CMP 


Compare with accumulator 


Action 


(A)-data -► F 


Description Contents of memory location or immediate data 

are subtracted from the accumulator. If the result 
is zero then bit Z is set; if not zero it is cleared. If 
the result is negative then bit N is set; if positive it 
is cleared. Bit C is set if the accumulator contents 
are greater than or equal to the data. The contents 
of the accumulator remain unchanged; only the 
flags register is affected. 


Addressing modes Immediate 

Zero-page 

Absolute 

Indexed 

Indirect/indexed 


Flags affected NZC 


CPX 


Compare with X register 


Action (X)-data -► F 

Description Contents of memory location or immediate data 

are subtracted from the X register. If the result is 
zero then bit Z is set; if not zero it is cleared. If the 
result is negative then bit N is set; if positive it is 
cleared. Bit C is set if the X register contents are 
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greater than or equal to the data. The contents of 
the X register remain unchanged; only the flags 
register is affected. 

Addressing modes Immediate 

Zero-page 

Absolute 

Indexed 

Indire ct/ indexed 
Flags affected NZC 


CPY 


Compare with Y register 


Action (Y)-data -► F 

Description Contents of memory location or immediate data 

are subtracted from the Y register. If the result is 
zero then bit Z is set; if not zero it is cleared. If the 
result is negative then bit N is set; if positive it is 
cleared. Bit C is set if the Y register contents are 
greater than or equal to the data. The contents of 
the Y register remain unchanged; only the flags 
register is affected. 

Addressing modes Immediate 

Zero-page 

Absolute 

Indexed 

Indirect/indexed 

Flags affected NZC 


DEC 


Decrement memory 


Action M ■*- (M)-l 

Description The contents of the specified memory location are 

decremented by 1. 
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Addressing modes 

Zero-page 

Absolute 

Indexed (X only) 

Flags affected 

NZ 

DEX 

Decrement X register 

Action 

X- (X)-l 

Description 

The contents of the X register are decremented by 
1. 

Addressing modes 

Implied 

Flags affected 

NZ 

Comments 

Enables X to be used as a counter. 

DEY 

Decrement Y register 

Action 

Y- 00-1 

Description 

The contents of the Y register are decremented 
by 1. 

Addressing modes 

Implied 

Flags affected 

NZ 

Comments 

Enables Y to be used as a counter. 

EOR 

Logical exclusive-OR 

Action 

A-*- (A) EOR data 

Description 

Exclusive-OR the contents of memory location or 
immediate data with the accumulator. Result is 
placed in the accumulator. 
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Addressing modes 

Flags affected 
Comments 

INC 

Action 

Description 

Addressing modes 

Flags affected 

INX 

Action 

Description 

Addressing modes 
Flags affected 
Comments 

INY 


Immediate 

Zero-page 

Absolute 

Indexed 

Indirect/indexed 

NZ 

See BASIC EOR for truth table. 


Increment memory 


M— (M)+l 

The contents of the specified memory location are 
incremented by 1. 

Zero-page 
Absolute 
Indexed (X only) 

NZ 


Increment X register 


X—(X)+1 

The contents of the X register are incremented by 

1 . 

Implied 

NZ 

Enables X to be used as a counter. 


Increment Y register 


Action 


Y—(Y)+1 
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Description 

Addressing modes 
Flags affected 
Comments 

JMP 

Action 

Description 

Addressing modes 

Flags affected 
Comments 


JSR 

Action 

Description 

Addressing modes 
Flags affected 
Comments 


The contents of the Y register sire incremented by 

1 . 

Implied 

NZ 

Enables Y to be used as a counter. 


Unconditional jump 


PC address 

Execution continues at the specified label or 
address. 

Absolute 

Indirect 

None 

There is no restriction on length of jump; label or 
address may be anywhere in memory. This is the 
only instruction which may use straight indirect 
addressing. 


Jump to subroutine 


STACK'*- (PC)+2 
PC address 

The contents of the program counter plus 2 are 
pushed on the stack (this is the address of the 
instruction following JSR). Execution continues 
at the specified label or address. 

Absolute 

None 

The subroutine to which control is transferred 
must be terminated by an RTS instruction. JSR is 
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LDA 

Action 

Description 

Addressing modes 

Flags affected 

LDX 

Action 

Description 

Addressing modes 

Flags affected 

LDY 

Action 

Description 


used whenever you wish to make an operating 
system call from assembler. 


Load accumulator 


A data 

Load the accumulator with contents of memory 
location or immediate data. 

Immediate 

Zero-page 

Absolute 

Indexed 

Indirect/indexed 

NZ 


Load X register 

X ■+- data 

Load the X register with contents of memory 
location or immediate data. 

Immediate 
Zero-page 
Absolute 
Indexed (Y only) 

NZ 


Load Y register 

Y data 

Load the Y register with the contents of memory 
location or immediate data. 
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Addressing modes 

Flags affected 

LSR 

Action 

Description 

Addressing modes 

Flags affected 
Comments 

NOP 

Action 

Description 

Comments 

ORA 


Immediate 
Zero-page 
Absolute 
Indexed (X only) 

NZ 


Logical shift right 


0 A or M-^C 

Shift the contents of the accumulator or memory 
location right one bit position. Bit 0 falls into the 
carry (bit C), zero is entered from the left. Result 
remains in either the accumulator or memory 
location. 

Zero-page 
Absolute 
Indexed (X only) 

Accumulator 

NZC 

LSR A acts on the accumulator. 


No operation 


None 

Does nothing for two clock cycles. 

Used for timing a program, or to fill in gaps caused 
by deleted instructions. 


Logical OR 


Action 


A •*- (A) OR data 
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Description 

Addressing modes 

Flags affected 
Comments 

PHA 

Action 

Description 

Addressing modes 
Flags affected 

PHP 

Action 

Description 

Addressing modes 
Flags affected 


OR the content s of memory location or immediate 
data with the accumulator. Result is placed in the 
accumulator. 

Immediate 

Zero-page 

Absolute 

Indexed 

Indirect/indexed 

NZ 

See BASIC OR for truth table. 


Push accumulator on to stack 


STACK-*- (A) 

SP—(SP)-l 

The contents of the accumulator are pushed on to 
the stack. The stack pointer is decremented. The 
accumulator contents remain unchanged. 

Implied 

None 


Push flags register on to stack 


STACK—(F) 

SP — (SP)-l 

The contents of the flags register are pushed on to 
the stack. The stack pointer is decremented. The 
flags register contents remain unchanged. 

Implied 

None 
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PLA 


Pull data from stack into accumulator 


Action 

Description 

Addressing modes 
Flags affected 


A"*- (STACK) 

SP—(SP)+1 

Pull the top byte of the stack into the accumulator. 
Increment the stack pointer. 

Implied 

NZ 


PLP 


Pull data from stack into flags register 


Action 

Description 

Addressing modes 
Flags affected 


F — (STACK) 

SP^(SP)+1 

Pull the top byte of the stack into the flags register. 
Increment the stack pointer. 

Implied 

NVBDIZC 


ROL 


Rotate left 


Action 


A or M'* - 
—C- 


Description Rotate the contents of the accumulator or memory 

location left one bit position. The carry (bit C) is 
entered from the right, bit 7 falls into the carry. 

Addressing modes Zero-page 

Absolute 
Indexed (X only) 

Accumulator 


Flags affected NZC 

Comments ROL A acts on the accumulator. This is a 9-bit 

rotation. 
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ROR 

Action 

Description 

Addressing modes 

Flags affected 
Comments 

RTI 

Action 


Description 

Addressing modes 
Flags affected 
Comments 


Rotate right 


—►A or M— 

-C-- 

Rotate the contents of the accumulator or memory 
location right one bit position. The carry (bit C) is 
entered from the left, bit 0 falls into the carry. 

Zero-page 
Absolute 
Indexed (X only) 

Accumulator 

NZC 

ROR A acts on the accumulator. This is a 9-bit 
rotation. 


Return from interrupt 

F — (STACK) 

SP — (SP)+1 
PCL — (STACK) 

SP — (SP)+1 
PCH — (STACK) 

SP — (SP)+1 

Restore the contents of the flags register and the 
program counter, which were previously stored on 
the stack. Increment stack pointer. 

Implied 

NVBDIZC 

Used to return to the execution of a program, after 
an interrupt has been dealt with. 
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RTS 

Action 


Description 

Addressing modes 
Flags affected 
Comments 

SBC 

Action 

Description 

Addressing modes 


Flags affected 
Comments 


Return from subroutine 


PCL — (STACK) 

SP — (SP) + 1 
PCH — (STACK) 

SP — (SP)-fl 
PC — (PC)+1 

Restore the contents of the program counter, 
which were previously stored on the stack, and 
increment the program counter by 1. Increment 
the stack pointer. 

Implied 

None 

Continues execution from position after sub¬ 
routine call. Used by the Electron’s assembler to 
return to BASIC. 


Subtract with carry 


A — (A)-data-C 

(C is NOT C, which is the borrow.) 

Subtract the contents of memory location or 
immediate data from the accumulator, with bor¬ 
row. Result is placed in the accumulator. 

Immediate 

Zero-page 

Absolute 

Indexed 

Indirect/indexed 

NVZC 

To subtract without the borrow, bit 0 must be set 
beforehand by using SEC. 
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SEC 


Action 
Description 
Addressing modes 
Flags affected 
Comments 


C — 1 
Bit C is set. 

Implied 

C 

Often required before SBC. 


Set carry 


SED 


Set decimal flag 


Action D 1 

Description Bit D is set, which means that the processor is in 

decimal mode (BCD). 


Addressing modes Implied 
Flags affected D 


SEI 


Set interrupt mask 


Action 
Description 
Addressing modes 
Flags affected 


I—1 

Bit I is set, which disables interrupts. 

Implied 

I 


STA 


Store accumulator in memory 


Action M (A) 

Description Store contents of the accumulator at the specified 

memory location. The accumulator contents re¬ 
main unchanged. 
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Addressing modes 

Immediate 

Zero-page 

Absolute 

Indexed 

Indirect/indexed 

Flags affected 

None 

STX 

Store X register in memory 

Action 

M«-(X) 

Description 

Store contents of X register at the specified 
memory location. The X register contents remain 
unchanged. 

Addressing modes 

Zero-page 

Absolute 

Indexed (zero-page Y only) 

Flags affected 

None 

STY 

Store Y register in memory 

Action 

M—(Y) 

Description 

Store contents of Y register at the specified 
memory location. The Y register contents remain 
unchanged. 

Addressing modes 

Zero-page 

Absolute 

Indexed (zero-page X only) 

Flags affected 

None 
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TAX 

Action 

Description 

Addressing modes 
Flags affected 

TAY 

Action 

Description 

Addressing modes 
Flags affected 

TSX 

Action 

Description 

Addressing modes 
Flags affected 

TXA 


Transfer accumulator to X 


X —(A) 

Copy the contents of accumulator into X register. 
The accumulator contents remain unchanged. 

Implied 

NZ 


Transfer accumulator to Y 


Y-(A) 

Copy the contents of accumulator into Y register. 
The accumulator contents remain unchanged. 

Implied 

NZ 


Transfer stack pointer to X 

X—(SP) 

Copy the contents of the stack pointer into X 
register. The stack pointer contents remain un¬ 
changed. 

Implied 

NZ 


Transfer X register to accumulator 


Action 


A-(X) 
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Description 

Addressing modes 
Flags affected 

TXS 

Action 

Description 

Addressing modes 
Flags affected 

TYA 

Action 

Description 

Addressing modes 
Flags affected 


Copy the contents of the X register into the 
accumulator. The X register contents remain 
unchanged. 

Implied 

NZ 


Transfer X register to stack pointer 


S - (X) 

Copy the contents of the X register into the stack 
pointer. The X register contents remain un¬ 
changed. 

Implied 

NZ 


Transfer Y register to accumulator 


A-(Y) 

Copy the contents of the Y register into the 
accumulator. The Y register contents remain 
unchanged. 

Implied 

NZ 
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VDU codes 


VDU A is equivalent to PRINT CHR$ A; 

VDU A,B,C is equivalent to PRINT CHR$ A; CHR$ B; CHR$ C; 

This chapter is a description of the whole character set from 0 to 255 
which can be used with either VDU or PRINT CHR$. The ASCII table is 
in Appendix F, and you will see that codes from 0 to 31 give control 
characters for the screen display; codes 32 to 127 generate visual 
characters; and the remainder are initially undefined. 

Here is each code in detail: 


Code 

0 

1 

2 

3 

4 


Keyboard 


CTRL 


CTRL 


CTRL 


CTRL 


CTRL 


A 

B 

C 

D 


5 


CTRL 


E 


CTRL 


7 

8 


CTRL 


CTRL 


G 

H 


CTRL 


I 


Description 

Does nothing. 

Reserved. 

Reserved. 

Reserved. 

Allows the text cursor and the 
graphics cursor to operate 
independently of one another. 
(Reverses the action of VDU 5.) 
Causes the text cursor to be joined 
to the graphics cursor. The text 
cursor ceases to exist, and characters 
are printed at the graphics cursor 
which is positioned using MOVE. 
Allows output to be printed on the 
screen. (Reverses the action of 
VDU 21.) 

Causes a short ‘beep’ from the 
internal loudspeaker. 

Moves the text cursor back one 
space on the screen. Does not delete 
the previous character. 

Moves the text cursor forward one 
space on the screen. 
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10 


CTRL 


11 


CTRL 


K 


12 

13 


CTRL 

CTRL 


14 


CTRL 


N 


15 

16 

17 

18 
19 


CTRL 

CTRL 

CTRL 


CTRL 

CTRL 


Moves the text cursor down one line 
on the screen. If the cursor is already 
at the bottom then the screen will 
scroll up one line. 

Moves the text cursor up one line on 
the screen. If the cursor is already at 
the top then the screen will scroll 
down one line. 

Clears the text screen. Same as CLS. 
VDII13 issued as a co mmand (not in 
a program), or Mill! M, have 
exactly the same effect as 
In a program, VPU13 will move 
the text cursor to the start of the 
current line. 

Puts the display into paged mode. 
Programs will only be listed to fill 
the screen, and then the computer 


will wait until the 


SHIFT 


key is 


pressed before listing another screen 
full. Used when reading long 
programs. 

Cancels paged mode. (Reverses the 


action of 


CTRL 


N.) 


Clears the graphics screen. Same as 

CLG. 

Changes text colour. Same as 

COLOUR. 


Changes graphics colour, and colour 
mix. Same as GCOL. 

Assigns any logical colour value to 
any actual colour. For example, mode 
6 normally has two colours only, 
black and white, assigned the logical 
colour values 0 and 1. To change 0 
(black) to blue, use VDU19 with the 
logical colour 0, and the actual colour 
4 (blue). 


MODE 6 

VDU19, 9 . 4, 9 , 9 , 9 
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20 

21 


22 

23 


24 

25 

26 


27 

28 

29 

30 

31 

32-126 

127 


CTRL 

CTRL 


CTRL 


CTRL 


CTRL 

CTRL 

CTRL 



CTRL 

CTRL 

CTRL 

CTRL 


T 

U 


V 


Returns all logical colours to normal. 
(Reverses V0U19). 

U deletes the whole of the 
current line being typed. 

VDU21, in a program, disables all 
output to the screen. This is reversed 


by VDU6. 

Changes mode. VDU22.2 is 
equivalent to MODE 2, except that 
HI MEM is not altered. 


W Reprograms a displayed character. 

32 user-definable characters are set 
aside for use with VDU23. All the 
rest of the characters can be 
redefined if the memory is exploded 
with *FX20,1. 

X Defines a graphics window. 

Y Same as PLOT. VDU25.85.X,Y is the 

same as PLOT 85.X.Y. 

Z Reverses the effects of VDU24, 

VDU28, and VDU29. Graphics and text 
windows both occupy the whole 
screen; text origin and text cursor 
are at top left; graphics origin and 
graphics cursor are at bottom left. 

[ Reserved. 

, Defines a text window. 

- Moves the graphics origin. VDU29,X,Y 

will move 0,0 to position X.Y. 

Homes text cursor to top left of text 
window. 

/ VDU31,X,Y is the same as PRINT 

TAB(X,Y). 

SPACE to ^ The complete set of ASCII 

_ characters. 

Moves the text cursor back one 
space on the screen and deletes the 


DELETE 


character to the current background 
colour. 
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128-223 Normally undefined. Can be defined 

if memory is allocated using *FX20,1 
and VDU23. 

224-255 User-definable characters. Can be 

defined using VDU23. 



Appendix B 
Error messages 


When the computer is unable to continue executing a program or a 
command it will tell you by printing a message on the screen. As shown in 
the section on error trapping, these error messages can be suppressed 
provided you have written an alternative routine for the computer to 
follow using ON ERROR . . . 

As well as an error message, the computer sets two variables each time 
an error occurs: 

ERR gives the error number. 

ERL gives the line number at which the error was noticed. 

The error messages are listed here in alphabetical order, alongside their 
error numbers: 

Accuracy lost 23 

If you try to calculate trigonometric functions with very large angles you 
will lose a lot of accuracy in reducing the angle to within the range of plus 
or minus PI radians. When this happens the computer will print the 
above message, for example: 

PRINT C0S(11111111) 

Arguments 

This indicates that there are too many or too few arguments for a given 
function or procedure. 

Array 14 

This indicates that the computer expects an array, but cannot find it. 


Bad call 

Incorrect PROC or FN call. 


Bad command 

Wrongly typed OS command, for example: 


254 
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*FX2 M 

Bad DIM 10 

Arrays and memory must be dimensioned with a positive number of 
elements. For example, these will produce errors: 

DIM array{—10) 

DIM P% -2 

Bad hex 28 

Hex numbers may only consist of 0 to 9 and A to F. 

Bad key 251 

Error in *KEY command, including running out of space for key string, 
and attempting to re-define a key while it is in use. 

Bad MODE 25 

You cannot change mode inside a PROC or FN. Nor can you change to a 
mode which would make HI MEM less than LOMEM. 

Bad Program 

There are a number of occasions when the computer checks a program to 
see where it starts and ends in memory. The above error means that the 
computer could not follow the program successfully and that it is 
therefore aborted. This error is untrappable, which means that you 
cannot find out at which line it occurred, nor can you retrieve any part of 
the program! It is caused by part of the program becoming over-written 
either by a mode change or by another program’s BASIC variables. 

Block? 218 

This is an error generated by the cassette filing system. It means that the 
computer found a non-consecutive block number. Re-wind the tape a 
little way and try again. 

Byte 2 

Caused in assembly by trying to load a register in immediate mode with a 
value greater than 255, for example: 
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LDY #266 

Can’t match FOR 33 

The control variable associated with NEXT is different from that 
associated with FOR. 

Channel 222 

This error is generated by the cassette filing system when you try to use a 
file channel number which has not been opened. 


Data? 216 

This is an error generated by the cassette filing system which means that 
the computer has missed some data from a block. Re-wind the tape a 
little and try again. 

DIM space 11 

There is not enough memory for the array to be dimensioned. 

Division by zero 13 

You cannot divide by zero. 

$range 8 

Strings may not be placed in the zero-page of memory using the 

indirection operator $. This is illegal: 


$&70 = "error" 


Eof 223 

This error is given by the cassette filing system if the end of file is 
reached. 


Escape 
The 


ESCAPE 


key has been pressed. 


17 


Exp range 

You cannot exponentiate a number greater than 88. The following is 
illegal: 
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A = EXP 90 

Failed at. . . (line number) 

Caused by renumbering a program with a GOTO or GOSUB to a non¬ 
existent line number. 

15 X = 12 
34 GOTO 200 
48 END 

will give the error message: 

Failed at line 20 

File? 219 

This error is generated by the cassette filing system and means that the 
computer was given an unexpected file name. 

FOR variable 34 

The control variable in a FOR . . . NEXT loop must be numeric, for 
example: 

FOR 1$ = 0 TO 20 

is illegal. 

Header? 217 

This error is generated by the cassette filing system and it means that the 
computer cannot read the file’s header (which contains the name, block 
number etc). Re-wind the tape a little way and try again. 

Index 3 

This error occurs during assembly if you use an incorrect index mode, for 
example: 


LDA (&70,Y) 



Appendix B 273 


LINE space 

The computer has run out of memory for you to type any extra lines into a 
program. 


Log range 22 

You cannot find the log of a negative or zero number. 

Missing, 5 

This means that the computer expected to find a comma in the line, but 
didn’t do so, for example: 

C$ = LEFT$(Z$) 

Missing ” 9 

This means the computer expected to find a quote, for example: 

CHAIN "MARSLANDER 

Missing) 27 

This means the computer expected to find a closing bracket, for 

example: 

PRINT TAB(6,16 

Missing # 45 

This means the computer expected to find a hash, for example: 

?l% = BGET file 

Mistake 4 

This means that the computer could not understand the instruction, for 
example: 


10 PRIT 
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-ve root 21 

You cannot find the square root of a negative number. This may also 
occur with ASN and ACS. 

No GOSUB 38 

The computer encounters RETURN without having passed a GOSUB. 

No FN 7 

The computer encounters the end of a function definition without having 


passed the DEF FN, for example: 

= X 

No FOR 32 

The computer encounters NEXT without having passed the FOR. 

No PROC 13 

The computer encounters ENDPROC without having passed the DEF 

PROC. 

No REPEAT 43 

The computer encounters UNTIL without having passed the REPEAT. 

No room 0 


When a program is running, the computer uses the area of memory 
between LOMEM and HIMEM to store the BASIC variables. If there is 
insufficient room to store any more of these variables then the above 
error is given. This most commonly occurs with programs which use 
arrays in conjunction with a large screen mode (0, 1, 2, or 3). 

No such FN/PROC 29 

The computer encounters an FN or a PROC for which it can find no 
definition. 

No such line 41 

Electron BASIC does not allaow you to GOTO or GOSUB a line number 
which does not exist. 
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No such variable 26 

All variables must be declared, either globally by assigning them a value 
or locally by using LOCAL. If the computer encounters an un-declared 
variable it gives the above error. This error is also given in assembler 
when the computer encounters a forward reference to a label. 

No TO 36 

TO is omitted from the FOR . . . NEXT loop: 

FOR 1=0 

Not LOCAL 12 

Local variables may be declared only within an FN or a PROC. 

ON range 40 

The control variable for ON GOTO or ON GOSUB is either less than 1 or is 
greater than the number of entries in the list of line numbers. For 
example, the following will not work if destination = 3: 

ON destination GOTO 60,21 fl 

because there are only two destinations. This error may be accounted for 
by using ELSE: 

ON destination GOSUB 70,90 ELSE . . . 

ON syntax 39 

The word ON must be followed either by ERROR, or by a numeric variable 
and GOTO or GOSUB. The following will give an error: 

ON direction PRINT 

Out of DATA 42 

The computer encounters a READ instruction for which it cannot find an 
entry in the DATA list. RESTORE can be used to move the data-pointer 
back to the start of a DATA list. 
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Out of range 1 

Branch instructions in assembler can access not farther than 127 bytes 
forwards or 128 bytes backwards. To branch outside these limits you 
must use JMP or JSR. 

Silly 0 

Given by the automatic line numbering system AUTO or the line 
renumbering system RENUMBER if you attempt to use a step size of less 
than 1 or more than 255. 

String too long 19 

The maximum length of a string is 255 characters. 

Subscript 15 

An array subscript is out of range, either less than 0 or greater than the 
value declared in DIM. 

Syntax 220 

Bad syntax in the cassette filing system. 

Syntax error 16 

A statement is incorrectly terminated, for example: 

LIST. 50 

Too big 20 

The computer calculates a number which is too big or too small to be 
represented. 

Too many FORs 35 

FOR ... NEXT loops may be nested to a depth of 10, and the control vari¬ 
ables must all be different. 


Too many GOSUBs 

GOSUB . . . RETURN loops may be nested to a depth of 26. 


37 
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Too many REPEATS 44 

REPEAT. . . UNTIL loops may be nested to a depth of 20. 

Type mismatch 6 

You cannot assign a string to a numeric variable or a number to a string 
variable. 
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Operating system calls 


The computer’s operating system is a program, stored in read-only 

memory, which runs continually, sorting out what goes where and when. 

Some parts of the operating system can be accessed from BASIC, and 

these instructions all begin with an asterisk. When executing BASIC, the 

computer will pass these instructions straight to the operating system. 

Here is a list of available commands: 

*CAT Catalogues all file names on cassette, and displays them 

on the screen. Can be shortened to *. 

*SAVE Saves a section of memory onto tape. *SAVE "File" 1000 

10FF102A will save a page of memory, called File, from 
address &1000 to&10FF, and an execution address (for 
use by *RUN) of 102A. If the execution address is 
omitted, it is assumed to be equal to the start address. 

*R U N Loads and runs a program stored by *SAVE. *RU N "File" 

will load and run the example given in*SAVE above. 

*L0AD Loads a file and stores it in memory at a specified 

address. *L0AD "Game" 2000 will load from tape a file 
called Game, and store this at location &2000 

*0PT Determines the computer’s reaction to errors during 

cassette operations. 


*0PT1,X 

Controls the error messages given. 

X = 0 

Gives no messages. 

X = 1 

Gives short messages (as normal). 

X- 2 

Gives long messages, including load and 
execution addresses. 

*0PT2,X 

Controls the computer’s action. 

X = 0 

Lets the computer ignore all errors, and 
carry on regardless. Messages can still be 
given. 

X = 1 

The computer asks you to try again by re¬ 
winding the tape (as normal). 

X = 2 

The computer aborts the operation. 
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*0PT3,X Sets the inter-block gap - the time delay 
between each page of memory stored on 
the tape. X determines the gap in tenths 
of a second. This only applies to PRINT# 
and BPUT# . The gap on SAVE is fixed at 
0.6 seconds. 

*0PT On its own sets all the values to normal. 

*SP00L Used for saving a program listing or results (as long as 

they are ASCII characters) to cassette or disc as a text 
file. Thus *SP00L FRED opens a file called FRED on 
either tape or disc. Whatever characters appear on the 
screen after that (eg a program listing called up by LIST, 
or one you enter on the keyboard) will be saved to 
FRED as a text file. To close the file, type *SP0QL 
at the end. 

*EXEC Loads a file from tape, as input rather than as a 

program. Used for loading a file which has been 

♦SPOOLed. 

* MOTOR Used to turn the cassette motor relay on or off. 

*MOTOR0 for off, *M0T0R1 for on. 

*KEY Programs a user-defined function key. 

*FX A family of operating system commands which are 

described in Appendix D. 

♦help Gives version numbers of current software. 
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*FX calls 


*FX calls provide a variety of controls for operating system functions 
such as auto-repeat, flash-rate, buffer-flushing, memory allocation etc, 
etc. The following is a description of all *FX calls available from BASIC. 


Call 

*FX0 

*FX4 


*FX9 

*FX10 


Description 

Prints a message on the screen telling which operating 
system you have. Operating systems are updated from 
time to time by the manufacturer. 

Controls the operation of the four ‘arrow’ keys and 


COPY 


*FX4,1 disables their editing function, and causes them 
to generate ASCII codes, just like any other key: 


135 


‘left-arrow’ key 136 

‘right-arrow’ key 137 

‘down-arrow’ key 138 

‘up-arrow’ key 139 


*FX4,2 allows the five keys to be user-programmable. 
Their key values become: 


COPY 


‘left-arrow’ key *KEY12 

‘right-arrow’ key *KEY13 

‘down-arrow’ key *KEY14 

‘up-arrow’ key *KEY15 


*FX4,0 resets the keys to their normal function of 
editing. It reverses *FX4,1 and *FX4,2. 

Used to set the flash-rate of flashing colours. *FX9 
controls the duration of the first colour, *FX1| the 
duration of the second. 
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*FX11 


*FX12 


*FX13 

*FX14 

*FX15 


*FX9,25 

*FX10,25 

Will set each colour to stay on for equal time of 25 
fiftieths (%) of a second. These are in fact the normal 
values when the machine is switched on. 

You could change them to: 

*FX 9.40 
*FX10,20 


which will make the first colour stay on for twice as long 
as the second; for 4/5 and 2/5 of a second respectively. 
If one duration is set to 0, the other colour will stay on all 
the time. 

Sets the delay, when a key is pressed, before the auto¬ 
repeat comes into action. 

*FX11,50 will set the delay to 50 hundredths (Vfe) of a 
second. 

*FX11,0 turns off the auto-repeat altogether. 

Sets the period of auto-repeat. 

*FX12,10 sets the auto-repeat to 10 hundredths (1/10) 
of a second between characters, giving 10 characters 
per second. 

*FX12,0 resets both *FX11 and *FX12 to their normal 
values. As an example, type in the following: 


*FX12,1 

*FX11,1 


RETURN 

RETURN 


and now try typing in anything at all! 

Disable/enable events. 

See chapter on Assembly Language. 

Flushes (empties) certain buffers (short term mem¬ 
ories). 
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*FX18 

*FX19 

*FX20 


*FX15,9 flushes all buffers. 

*FX15.1 flushes the currently selected input buffer. 

Resets all the user-programmable keys to empty. 

Makes the computer wait for the start of the next screen 
display frame. 

Determines the amount of memory which can be set 
aside for character definitions. 

*FX2M implodes the character definitions. This means 
that the extra memory set aside for extra character 
definitions by*FX2(Mto*FX20,6 is returned to the user 
for storing BASIC programs. 

♦FX2J.1 to *FX20.6 explodes the memory to store 
groups of 32 extra character definitions. All characters 
with ASCfl codes 32 to 255 may be user defined. As 
described in chapter 21, ASCII codes 128 to 255 may be 
defined without using a *FX20 command, but only 32 
consecutive characters can be defined. *FX20.1 to 
*FX29.6 take chunks of memory from the BASIC 
program storage area to hold specific definitions, and 
this is shown in the table below. 


ASCII code 

*FX 

128-159 

*FXZ0,0 

160-191 

*FX20,1 

192-223 

*FX20,2 

224-255 

*FX20,3 

32- 63 

*FX2( ,4 

64- 95 

*FXZ0,5 

96-127 

♦FX20.6 


Memory allocation 
&C00 to &CFF 
OSHWM to OSHWM + &FF 
OSHWM + &100 to OSHWM+ & IFF 
OSHWM + &200 to OSHWM+ &2FF 
OSHWM + &300 to OSHWM + &3FF 
OSHWM +&400 to OSHWM+ &4FF 
OSHWM + &500 to OSHWM + &5FF 


OSHWM stands for Operating System High Water 
Mark, and means the point where the memory (from 
&000) occupied by the operating system ends, and the 
memory occupied by BASIC programs begins. Turn to 
chapter 23 for the computer’s memory map. The 
OSHWM normally sits at &E00, but this will change 
when a software expansion has been fitted, eg a disc 
filing system. 

If you explode the memory allocation in this way you 
must remember to reset PAGE higher up the memory. A 
program stored at &E00 may be lost. 
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*FX21 


*FX124 
*FX125 
*FX126 

*FX138 

*FX225 

*FX226 

*FX227 


Flushes (empties) certain buffers (short term mem¬ 
ories). 

*FX21,( flushes the keyboard buffer. 

♦FX21.4 flushes sound channel 0. 

*FX21,5 flushes sound channel 1. 

*FX21,6 flushes sound channel 2. 

*FX21,7 flushes sound channel 3. 

Used to reset the flag at memory location &00FF which 
tells when an ESCAPE has occurred. 


Sets the above-mentioned flag. Has similar effect to 


pressing the 


ESCAPE 


key. 


Used when reading characters from an input stream 
using OSRDCH.*FX126 acknowledges the detection of 
an ESCAPE. 


Used to insert a character into the keyboard buffer. 


*FX138,0,X will insert CHR$ X. 
Disables all the user-definable keys. 


Disables 

Disables 



A to 



Q onwards. 


P. 


With a parameter valu e other than the two given above, 

keys to give AS CII codes. 

A to give 


FUNC 


FUNC 


*FX225-227 will cause, 

For example, *FX226,224 will cause _ 

224, liilia B to give 225, etc. At this setting (*FX226, 
224), IJIWM A onwards will give the standard range of 
user-defined characters direct from the keyboard. Any 
number from 2 to 255 may be used as the parameter for 
*FX226, and det ermines the base code, which will be 
A. 


given by 


FUNC 


Appendix E 
Fast and efficient 
programs 


Programming 

The book which accompanies this one, called Start Programming with the 
Electron, is intended as a guide to writing programs in Electron BASIC. 
Once you start writing your own programs, however small they may be, 
please make good use of the Start Programming with the Electron book. It 
will help you to develop a good style and help you to avoid getting into 
bad habits. You will find the programs referred to in the book on the 
Introductory Cassette. 

Speeding up programs 

There may be times where the program must run as quickly as possible, 
and here are a few tips for increasing execution speed. 

- Use integer variables rather than real variables wherever possible. 

- Use integer division (DIV) rather than normal division (/). 

- Use integer arrays rather than real arrays. 

- Start your variable names with different letters of the alphabet. 

- Omit the control variable after the instruction NEXT. 

- REPEAT . . . UNTIL loops are faster than IF ... . THEN GOTO loops. 

- Use procedures instead of GOSUBs. 

- Use as few line numbers as possible by using a colon to separate each 
statement. 

- Leave out as many spaces as possible, without confusing the com¬ 
puter. 

- Omit REM statements. 

Some of these tips will have the effect of making your programs less 
readable. This is not a good thing, but in cases where speed is all 
important, you may find that you will have to reach a compromise between 
readability and execution speed. 



Appendix F 
ASCII displayed 
character set and 
control codes 


* 






^ ^ ^ 




Nothing 


Down 


Default 

logical 

colours 


Move text 
cursor 
to 00 



Next to 
printer 


Up 


Disable 

VDU 


Move 

text 

cursor 


Start 

printer 


Clear 

text 


Select 

mode 


Stop 

printer 


Start of 
line 


Reprogram 

characters 


Separate 

cursors 


Paged 

mode 


Nothing 


Join 

cursors 


Scroll 

mode 


Plot 


Enable 

VDU 


Clear 

graphics 


Default 

text/ 

graphics 

areas 


Beep 


Define 

text 

colour 


Define 

graphics 

area 


Back 


Define 

graphics 

colour 


Define 

text 

area 


Forward 


Define 

logical 

colours 


Define 

graphics 

origin 


Each displayed character consists of 8 rows of 8 dots 
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Appendix G 
Text and graphics 
planning sheets 

User defined planning sheet 


00 

CSJ -<* CS 

»-t <£> 00 00« .-H 
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Text planning sheet 
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fZ&l 
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Graphics planning sheet 2 (decimal) 



1000 1100 1200 1280 






























EL MATERIAL EXHIBIDO 
ES SOLO PARA USO 
EDUCATIVO, NO COMERCIAL 



ENCICLOPEDIA DE 
REFERENCIA | EDUCATIVA 


PARA ENTENDER LA EVOLUCION DE LOS ORDENADORES A TRAVES DEL TIEMPO 




